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Overview 


This manual is the operations guide for Valid 


applications software on a SUN Workstation running un- 
der the UNIX operating system. Some of the topics 
covered in this manual include: 


o Installing Valid software 

e Creating user accounts 

© Making tape backups of design data 

@ Managing Valid design files and directories 


© Setting up plotters and printers 


Overview 


This manual assumes that you have a basic working 
knowledge of UNIX and the Sun workstation hard- 
ware. Study the Sun Beginner’s Guides if you are not 
familiar with any of these areas of the system’s 
operation. 


This manual is a supplement to the System 
Administration for the Sun Workstation. Frequent refer- 
ences are also made to Sun UNIX manual pages in the 
UNIX Commands Reference Manual and the UNIX 
Interface Reference Manual included with your Sun 
Workstation documentation. 
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Installing 
Valid Software 


This section explains how to configure and install Valid 


software on a Sun Workstation. Updates to Valid 
software are also discussed. 


Read this entire section before you start the installation! 


Valid Software Installation 


installation Before you begin, you should be familiar with both the 
. Sun software installation procedure and Sun’s system 
Requirements administration documentation. In addition, you 


should have access to the Sun manual set. In 
particular, you should read these Sun manuals: 


Sun System Overview. 
System Administration for the Sun Workstation. 


SunOS 4.X Release Manual for the Sun 3 and 
Sun 4 workstations. 


Installing UNIX on the Sun Workstation. 


You will need the following tapes and documentation: 


Complete Sun documentation. 


SUNBIN 4.X 68020 release and upgrade tapes 
for Sun 3 or 4.X SUNBIN SPARC release for 
Sun 4. 


Valid software installation and application 
tape(s). 


Valid library tape(s) (optional). 
Valid installation instructions (this manual). 


Any additional Valid installation notes that are 
packaged with your tapes. 
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Valid Software Installation 


Installation 
Overview 


This installation procedure 
assumes that you are only using 
your Sun to run Valid 
applications. If you are running 
other software, you may need to 
modify this procedure. 
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There are a number of steps involved in configuring 
and installing Valid software on your Sun 
workstation. Depending on your exact configuration, 
for example, whether or not you have already in- 
stalled the Sun software on the workstation, you may 
be able to skip some of these steps. 


The procedure is: 


e Determine your local and network disk space 
requirements. | 


e Install the Sun software. 
e Install the Valid software. 
e Configure network file access. 


e Configure your Access License servers and 
clients. 


eo Create accounts for users as explained in 
Section 4. 


e Create Real Products devices, and spooler 
directories, if necessary. Configure any ma- 
chines that have Real Products and/or Versatec 
printers and plotters by modifying the kernel, 
as explained in Appendix B. 


e Configure printers and/or plotters. Plotter 
setup is explained in Section 7; installation of 
the Ikon 10088 printer interface board is 
explained in Appendix A. 
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Valid Software Installation 


Determining 
Disk 
Requirements 


2-4 


The Network File System (NFS) and disk servers allow 
many possible disk configurations. If this is the first 
software installation on your workstation, plan your 
disk space needs carefully so that you do not run into 
problems later on. 


This section describes how the Valid software and 
libraries can be organized on standalone systems, 
servers, and clients. Once you have decided how to 
organize the software and libraries, you can decide 
where they are to be installed. 


Your disk space needs depend on what Valid applica- 
tion software you have ordered, what other non—Sun 
software you have installed, and the type of work you 
will be doing on the workstation. The disk 
configuration should allow enough room for your 
software and component libraries and some room for 
future growth. It should also allow enough space for 
the design data that will be created on the system. 
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Valid Software Installation 


Valid Software 
Organization 
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Valid recommends installing all Valid application 
software and libraries in /home/valid and creating a 
symbolic link to /usr/valid. Application software is lo- 
cated under the directory /usr/valid/tools.sun3 for Sun 
3 systems or /usr/valid/tools.sun4 for Sun 4 systems. 
Most software packages occupy a subdirectory in the 
“tools” directory. For example, the Graphic Editor 
(GED) is in either /usr/valid/tools.sun3/editor or in /usr/ 
valid/tools.sun4/editor. The directory /usr/valid/tools is 
linked to the appropriate “tools” directory (tools.sun3 
or tools.sun4). Libraries are common between Sun 3 
and Sun 4 workstations and occupy subdirectories in 
/usr/validfib. For example, the LSTTL library is lo- 
cated in /usr/valid/lib/|sttl. 


All of the Valid executable programs (or scripts to 
run them) are located in the “bin” directory under 
“tools.” To run any of these Valid programs, you 
must add the directory /usr/valid/tools/bin to each 
user’s PATH environment variable (the link from 
tools.sun3 or tools.sun4 is followed). The procedure for 
adding a PATH variable is included in page 2-15 of 
this manual. 
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Disk Space The approximate disk space requirements for the 

Requirements most common Valid software configurations are 
listed in Tables 2-1 and 2-2. Use these lists to deter- 
mine your disk space needs for Sun3 and Sun4 sys- 
tems before you start the installation. If space is criti- 
cal and you need more exact information, see the in- 
dividual release notes sent with your Valid Software 
distribution. Both the library and application package 
sizes generally increase with each new release. 


Table 2-1. Application Package Disk Space Requirements 


Application Package | Required Disk Space 
Sun3 Sun4 


System Utilities 

Entry Design (ED) 
Logic Design (LD) 
Validation Design (VLD) 
Transcribe 

Allegro (PCB) 
Integrated Chip (IC) 


Required for all systems 
Includes System Utilities 
Includes ED 

Includes ED and LD 


Does not include System Utilities 


Includes System Utilities 


Construct 10.5 Mb 
Compose 3.4 Mb 

9.6 Mb 
Timemill 1.9 Mb 
Pathmill 1.7 Mb 
Timeview 7.6 Mb 
DRC 0.7 Mb 
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Valid Software Installation 
Table 2-2. Library Disk Space Requirements 


; Required Required 
Disk Space * merely Disk Space * 


advpal pcblib 
alsttl sttl 

asttl ttl 

cmos 10k 
discrete 100k 
fast 54alsttl 
hcmos 54asttl 
ifl 54fast 
Isttl 54hcmos 


memory 54lsttl 


mm74c 54sstl 
newpal20 54ttl 
newpal24 


* Please note that library size remains constant for both Sun3 and Sun4 systems 
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Valid Default Disk Valid’s disk partition default is to install software in 

Partitions the /home partition on a single disk system, and 
/homel on a two-disk system. Valid recommends that 
the /usr partition contain SunOS files and that the Val- 
id tools and libraries reside in /home or /home!I with a 
symbolic link from /usr/valid to /home/valid or 
/home I/valid. 


Table 2-3 shows Valid’s disk partitioning defaults. 


Table 2-3. Valid Default Disk Partitioning on Sun Workstations 


For all systems (excluding Sun-4/60GX-P4) 


16 Mb 

40 Mb 

65 Mb 
remainder of disk 
second disk 


For Sun-4/60GX-P4 (2 x 104 MB disks with floppy) 


16 Mb 

40 Mb 

remainder of disk 
second disk 


* Note: /usr/valid is linked to /home/valid or /home1/valid on all systems 
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Valid Software Installation 


Valid Software on 
Standalone Systems 


2/15/90 


There are three practical options for a purely stand- 
alone system with no file systems mounted via NFS. 


e Place both application software and libraries 
on one disk partition. 


e Place application software on one disk parti- 
tion and libraries on another partition. 


e® Place application software and selected librar- 
ies on one disk partition and the remaining li- 
braries on another disk partition. 


Wherever the applications and libraries are physically 
installed, the system must be set up to have them logi- 
cally installed in the paths described previously in 
“Valid Software Organization.” Logical installation is 
done using entries in the /etc/fstab file and symbolic 
links across file systems. 


For single-disk systems, both the application soft- 
ware and the libraries are on the same disk. For two- 
disk systems, Valid recommends that software is in- 
stalled in /home/valid which is symbolically linked to 
/usr/valid. If your libraries also fit on the first disk, put 
them there under /usr/valid/lib. If you must split the 
libraries between two disks, you must create symbolic 
links for each library on the second disk back to /usr/ 
valid/lib on the first disk. Another option for two-disk 
systems is to partition the second disk into two or 
more file systems during setup, mount one partition 
on /usr/valid/lib, and use the other partition(s) as user 
file systems. 
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Valid Software Installation 


Valid Software on 
Servers 


For more information, 
see Creating the Links, 
p. 2-14, 
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Many different configurations are possible if you have 
several systems linked with Ethernet, or servers with 
diskless clients. 


If possible, install all of the Valid applications and 
libraries on a single server. Mount the appropriate 
tools directory (/usr/valid/tools.sun3 or /usr/valid/ 
tools.sun4) from the server on each client as /usr/valid/ 
tools.sunX and make a local link to /usr/valid/tools us- 
ing NFS. Sun 3 and Sun 4 executables can reside on 
the same server as long as care is taken when mount- 
ing the clients (See Valid Software Installation for 
more information). Since the libraries are identical 
for both a Sun 3 and a Sun 4, /usr/valid/lib can be 
mounted on either a Sun 3 or Sun 4. 


If none of your systems has enough disk space to hold 
both the applications and libraries, you can install the 
applications in /usr/valid/tools on one server and in- 
stall the libraries in /usr/valid/lib on another server. 
Clients would then mount both of these file systems in 
/usr/valid. This arrangement might also make sense 
on a system with a small disk; you could install the 
applications on your local disk and mount the librar- 
ies from a server. 


If you have a large number of workstations, you 
should consider setting up additional, duplicate serv- 
ers for the Valid applications and libraries. This re- 
dundancy prevents problems on one server from stop- 
ping work on all of your workstations. While it is pos- 
sible to divide the libraries among several servers, 
Valid recommends against this practice, as this can 
cause compatibility problems. 
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Valid Software Installation 


Sun Software 
Installation 


If you are using a Versatec 
plotter, see Section 7 and the 
Appendices of this manual for 
plotter information. 
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To install or upgrade your Sun system software, fol- 
low the instructions supplied by Sun. For a Sun3 or 
Sun4 system, Valid recommends installation of the 
SunOS4.X operating system. If a Sun3 client is served 
by a Sun4, they must both have SunOS4.X installed. 


The Sunview User, Sunview Programmer, and Net- 
working packages must be installed in order for the 
Valid graphics applications to run properly. Valid 
also recommends that you include the Install package 
in order that additional operating systems can be in- 
stalled at a future date. (The setup_exec utility is re- 
quired for all updates.) 
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Valid Software Installation 


Valid Software 
Installation 


To determine if a disk partition 
is already mounted, use the 
mount command without op- 
tions or arguments. 
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All Valid application software and libraries are in- 
stalled with vscript, the Valid software installation 
script. 


Your Valid installation tape includes this script and 
two installation utilities, one for software installation 
on a Sun3 and one for software installation on a Sun4. 
System configuration information is prompted by 
vscript which then uses the appropriate utility to in- 
stall the software. This section explains how to run 
vscript to install Valid application software and li- 
braries for initial installations and software updates 
on standalone systems and single-server systems. 


A server for the Valid applications must be installed 
before any of its clients can be configured. Do not 
install Valid applications software on a diskless sys- 
tem or any other system that does not have the appli- 
cations on the local disk. Instead, mount /usr/valid on 
the client using NFS. 


When you install the Valid software, the disk parti- 
tions to contain the Valid software must be mounted 
by entries in the /etc/fstab file. 
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Valid Software Installation 


First-time 
Installations 


Creating the Valid 
Directories 
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The following procedures are for first-time installa- 
tions only. (If you already have Valid System Tools 
on your system, move to the section Installing the Valid 
Software.) 


Whenever Valid application packages and libraries 
are installed, the system must be set up to have them 
logically installed in the paths /usr/valid/tools and /usr/ 
valid/lib. Logical installation is accomplished using 
symbolic links across file systems and with entries in 
the /etc/fstab file. For first-time installations, Valid 
recommends that the applications be physically in- 
stalled in /home/valid with the appropriate links to 
/usr/valid. See Creating the Links in this section for 
more information. 


To install the Valid application software, create the 
directory /home/valid and the sub-directories /home/ 
valid/lib and /home/valid/tools.sun3 and_ tools.sun4 
using the mkdir utility. Login as root and, at the UNIX 
prompt, type: 


cd /home 

mkdir valid 

mkdir valid/lib 

mkdir valid/tools.sun3 


mkdir valid/tools.sun4 
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Valid Software Installation 


Creating the Links To run the Valid applications, you must create a sym- 
bolic link between /home/valid and /usr/valid, and a 
second link between /usr/valid/tools.sun3 or tools.sun4 
and /usr/valid/tools. 


To create these links, type: 


ln -s /home/valid /usr/valid 


In -s /usr/valid/tools.sunxX /usr/valid/tools 


Creating the Lib Valid libraries are owned by the account “lib.” It is 

Account likely that a lib account does not exist on your system. 
If this is the case, create a “lib” account by adding 
entries to the password file /etc/passwd and the group 
file /etc/group. 


To add a lib account, insert the following line to the 
password file anywhere above the plus symbol (+): 


lib: *:8:8::/usr/valid/lib: 


Next, edit the group file /etc/group and add the follow- 
ing entry for lib: 


lib: *:8: 


If user ID 8 is already being used, choose any other 
value. However, the user ID for lib must be the same 
for every system on the network. 
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Valid Software Installation 


Changing Permissions 


Setting the PATH 
Variable 
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The Valid directories will be owned by root. To 
change the ownership, group, and permissions of the 
Valid directories to bin, type: 


chown bin valid 

chgrp bin valid 

chmod 755 valid 
Change the ownership and group of the tools and lib 
directories by typing: 

cd /home/valid 

chown bin tools* 

chgrp bin tools* 

chown lib lib 

chgrp lib lib 


Once you have created the necessary directories and 
links, you must add /usr/valid/tools/bin to the PATH 
variables in root’s .profile and .cshrc files. 


If you are using the Allegro (PCB) application, you 
must also add /usr/valid/tools/pcb/bin to the PATH vari- 
ables in root’s .profile and .cshrc files. 


Now that you have created the necessary directories 
and symbolic links, you are ready to begin the actual 
software installation. 
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Valid Software Installation 


Installing the The following procedures apply to both first-time 
. Valid installations and to Valid software updates. 
Valid 7 Your installation tape includes the vscript installation 
Applications script and two vinstaill utilities, one for installation on 
Sun3 workstations and one for installation on Sun4 

workstations. 


Valid software is password protected to prevent unau- 
thorized use. The individual passwords are keyed to 
the 8-digit host ID number of the machine chosen to 
be the Access server. Before proceeding with the in- 
stallation, make sure that the server’s host ID matches 
the number on the label of your installation tape. To 
determine your 8-digit host ID number for use during 
installation, type hostid at the prompt. 


If these numbers are different, quit the installation 
and call your Valid representative. 
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Valid Software Installation 


Using vscript If you have not already done so, load the installation 
tape and log onto your system as root. 


1 Change directories by typing: 


cd /usr 


2 The installation script and utilities are 
extracted from the installation tape using the 
tar command. This command automatically 
creates the directory /usr/valid/install if it does 
not already exist on your system. 


To extract this information from a 1/4-inch car- 
tridge tape, type: 


tar xvfp /dev/rsto 


To extract this information from 1/2-inch tape, 
type: 
tar xvfp /dev/rmto 


3 Change directories by typing: 


cd /usr/valid/install 


4 Run the installation script by typing: 


vscript 
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Valid Software Installation 


NOTE: If you are installing 
Valid applications in a mixed 
architecture environment, you 
must run vscript once for Sun3 
executables and a second time 
for Sun4 executables. 
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You are then prompted for the following user- 
specific information: 


What kind of tape are you installing: 
1) 1/4" cartridge tape 


2) 1/2" tape 


What kind of executables are you installing? 
1) SUN3 


1) SUN4 


Respond to both questions by entering the correct 


number and pressing (Return). To quit the 


installation procedure at any time, type q. 


You are then prompted to insert the appropriate appli- 
cation tapes and to verify that you are ready to begin 
the installation process. A message appears to inform 
you that the tape is being positioned. 
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The following is a sample list of packages from Tape 
1 of the Sun3 tape set. Depending upon your system, 
your selections may be different. 


OK OK KK KKK KKK KKK KKK KK KK KK KKK KKK ok OK KK KKK KKK K 


1) 
2) 
3) 
4) 
5) 
6) 
7) 


Valid System Tools 3.0 SUN3-P4 
ged 9.1 SUN3-P2 

hardcopy 3.4 SUN3-P2 

stdlib 9.0 SUN3-P1 

libutil 9.0 SUN3-P3 
validcompiler 1.4 SUN3-P4 


valid packager 2.0 SUN3-P9 


KKK KK KK KKK KK KK KK KK RK KK KK KKK KKK KK KK KK KK KK KKK KK KKK KKK 


You are asked to select the packages to be installed. 
Type a (for all) to install all of the applications in- 
cluded on the tape. (If you are only installing Valid 
System Tools, type "1".) The installation script veri- 
fies your selections and lists each package to be in- 
stalled: 


You have selected the following packages: 
package 1 
package 2 


package n 
Do you want to proceed? 


Enter "y" or "n": 
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Type y. Aseries of status messages is displayed, and 
vscript asks if you want to continue. Type y. The fol- 
lowing message appears: 


Proceeding with the installation 
- TAKE A BREAK 


When all the selected packages have been installed, 
you are instructed to insert the next application tape, 
if necessary. 


Extracting the software from tape for an initial instal- 
lation requires approximately 30 minutes; a complete 
software applications update requires approximately 
60 minutes. Library installation can require more 
than an hour depending on the size and number of the 
libraries being installed. 


If problems occur during the installation, vscript usu- 
ally describes the nature of the problem before exit- 
ing. Check the message file /tmp/vinstall.msg for error 
messages if you run into problems. If the problems 
are severe and you need to call Valid for assistance, 
save and print a copy of this file for reference. 
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Installing Sun 3 and 
Sun 4 Tools ona 
Server 
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Use vscript to install both the Sun3 and Sun4 pack- 
ages if you are setting up a server to serve both Sun3 
and Sun4 clients. To do so, complete the vscript pro- 
cedure, selecting Sun 3 at the prompt. When vscript 
has completed the installation, run vscript a second 
time and select Sun 4 at the prompt. 


Please note that the appropriate System Tools 
package must reside on the license server, regardless 
of the location of the Valid applications. For this 
reason, Valid System Tools must be installed for both 
Sun 3 and Sun 4 systems in a mixed architecture 
environment. 
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Access Control is an administrative tool that manages 
the security and the number of copies of an applica- 
tion running in a networked environment. 


Access Control monitors the number of licenses pur- 
chased for a given design group and distributes them 
on demand. Access to an application is provided ona 
first-come/first-serve basis until the allowed number 
of copies of that application are in use. Please note 
that a specific number of licenses are needed to run 
each copy of a Valid application. For Sun3 
workstations, four licenses are required for each 
application. For Sun4 workstations, five licenses are 
required for each application. 


The following section explains how to install Access 
Control for both single server and multiple server 
configurations. For an overview of Access Control 
and information about fault tolerant mode, see 
Administering Access Control, Section 3. 
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Once you have installed the Valid software on your 
system, the following procedures are used to confi- 
gure Access Control. Servers are configured first, fol- 
lowed by the client systems for each server. Please 
note that configuring a standalone system is the same 
as configuring a single server. 


Once the necessary directories and symbolic links 
have been created and the servers have been properly 
configured, the license manager daemon (/mgrd) can 
be invoked. During installation, the license file is in- 
stalled in the directory /usr/valid/tools/adm. The name 
of this file is “license” with an 8-digit hexadecimal 
extension that is the same as the host ID of the 
primary (first listed) license server. 


Check to make sure that the entries in the license file 
conform to the following syntax, and that there is an 
entry for each server: 


SERVER host_machine hostid 5200 


If the name of the host machine is not entered correct- 
ly, edit this entry to include the correct name. If the 
license file does not exist after installation or if the 
host ID for the machine is incorrect, contact Valid. 
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In addition to entries for each server, the license file 
contains entries for the valid] and valid2 daemons, 
and FEATURE entries for each package you have pur- 
; chased. In each FEATURE entry, previous to the en- 
concerning the license : tind 
file, see Access Control crypted 16-character field, you will find a reference 
Files, p. 3-11. to the number of licenses purchased for that 
FEATURE. 


For more information 


In order to reserve the TCP/IP 5200 communication 
port for exclusive use of Valid’s Access Control, 
Valid recommends the following procedures. 


1 Login as root and edit the /etc/services file. 


2 Move the cursor to the end of the file and add 
the following line: 


license 5200/tcp 


For additional information concerning the /etc/services 
file, please refer to the appropriate Sun 
documentation. 
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Editing the Template 
Files 
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Several template files are created during installation. 
These template files contain examples of files re- 
quired for Access Control to function properly. 


Once the server has been configured, the license man- 
ager daemon /mgrd, and the valid] and valid2 dae- 
mons are automatically started whenever the system 
is rebooted. In order for the license manager daemon 
to start automatically, a line must be added to the ex- 
isting /etc/rc.local file to read the special Valid startup 
file /etc/rc.valid. This special file is created from a 
template file and modified to include the server’s 
actual 8-digit host ID. 


To setup the server to automatically startup the 
license daemons: 


1 Change directories to /usr/valid/tools!adm by 
typing: 
cd /usr/valid/tools/adm 
2 Copy and rename the rc.local.template file: 
cp rc.local.template /etc/re.valid 
3 Change directories to /etc and change permis- 
sion of the new file by typing: 


cd /etc 
chmod 755 rc.valid 


4 Using vi, edit the rc.valid file and replace 
“HOSTID” with the actual 8-digit host ID. 
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5 Save the existing rc.local file by typing: 


cp re.local re.local.old 
6 Edit the existing rc.local file and add the 
following line at the end of the file: 


/etc/re.valid 


7 Start the daemons by typing: 
/etc/re.valid 
8 Check to make sure that the /mgrd daemon is 
running by typing: 
pS -aux. 


If the process is not running, please refer to 
Troubleshooting in Section 3 for instructions on 
Starting the daemons manually. 


NOTE | If you are running a multiple license server configura- 
tion, the license manager daemon must be invoked 
(Step #7) at each server and run concurrently. 
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Once you have edited the rc.local.template file, you 
must also include the 8-digit host 1D number of the 
Access server in your /usr/valid/tools/adm/servers file. 


1 Change’ directories and copy _ the 
servers.template file by typing: 


ed /usr/valid/tools/adm 
cp servers.template servers 


2 Change permission of the new file by typing: 


chmod 755 servers 


3 You must now edit the new servers file and, for 
each client running Valid software, include the 
clientname and the correct path to the license 
file. This must also be done for a standalone 
system. 


The servers.template file contains two entries, a tem- 
plate entry to be edited and an example. Once the file 
has been copied and the first line has been edited, the 
example line may be deleted from this file. Edit the 
first line to include the required user-specific infor- 
mation: 


clientname /usr/valid/tools/adm/license. servershostid 
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If you are running Access Control in a mixed architec- 
ture environment, you must copy the edited servers 
file to update each server’s servers file to the corre- 
sponding /adm directory in the other tools directory 
(tools.sun3 or tools.sun4). 


You must now edit your /etc/exports file: 
1 Include the following line in the server’s 
/etc/exports file: 


/usr/valid 


2 Update the “exports” list with the new infor- 
mation included in the exports file by typing: 


/etc/exportfs -a 


If an exports file does not exist on your system, create 
an executable /etc/exports file and include /usr/valid. 


Then reboot your system in order to restart the 
daemons. 
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Adding and In order to configure your system for multiple clients, 

Configuring Clients you must mount the server’s /usr/valid/tools.sunX and 
/usr/valid/lib directories with NFS entries in the client’s 
/etc/fstab file and include each of the clients in the 
server’s servers file. To configure multiple clients: 


1 Login as root and edit each client’s /etc/fstab 
file to include the following lines: 


hostname: /usr/valid/tools.sunX /usr/valid/tools.sunX nfs ro, hard 
hostname: /usr/valid/lib /usr/valid/lib nfs ro, hard 


2 Edit the /usr/valid/tools/admlservers file of the 
server to include an entry for each client. Each 
entry must specify clientname, the correct path 
to the license file, and the license file extension 
number of the license server’s host ID. 


3 For each client, you must make a fools and lib 
directory. To make these directories, at the cli- 
ent machine, login as root and type: 

cd /usr 

mkdir valid 

cd valid 

mkdir tools.sunX 
mkdir lib 
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For more information about 
mounting file systems, see the 
Sun Beginner's Guide: Using 
the Network. 


NOTE 
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4 Create a symbolic link between the tools direc- 
tories by typing: 


ln -s tools.sunxX tools 


5 Mount the server’s /usr/valid/tools and /usr/val- 
id/lib directories from the client by typing: 


/etc/mount -a 


Once you have created the necessary directories and 
properly mounted the server, you will be able to run 
the Valid applications on each client machine for 
which you have licenses available. 


In fault tolerant mode, should the mounted (active) 
license server become inaccessible, permission for 
continued use of Valid applications automatically 
transfers to a secondary (standby) license server. 
Please note that the new license server must be 
mounted in order to maintain access to the Valid 
application. 


For information about Access Control’s fault tolerant 
mode, see Section 3. 
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Separate License and Each client machine must be able to read the 

File Servers license.HOSTID file and the servers file located in the 
access license server’s /usr/valid/tools.sun3/adm or 
/usr/valid/tools.sun4/adm directory. 


If the client is mounting applications from a file 
server (or local disk) that is not the access license 
server, you must: 


1 On the client, change directories by typing: 


cd /usr/valid/tools 


2 Create an adm_license directory by typing: 


mkdir adm_license 


3 Edit the client’s /etc/fstab file and add the fol- 
lowing line to mount the license server’s adm 
directory on adm_license: 


license_server: /usr/valid/tools/adm /usr/valid/tools/adm_license nfs ro,hard 


In the above line, license_server is the hostname 
of your license server. 


4 Mount the license server’s adm directory by 


typing: 


/etc/mount /usr/valid/tools/adm_license 


5 On the client, change directories by typing: 


cd /usr/valid/tools/adm 
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6 Create symbolic links between the 
license.HOSTID and Servers files in the 
adm_license directory and the adm directory by 


typing: 


ln -s /usr/valid/tools/adm_license/license.HOSTID license.HOSTID 
ln -s /usr/valid/tools/adm_license/servers servers 
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Access Control 
Licenses 


A specific number of licenses are needed to run each 
copy of a Valid application, four licenses for a Sun3 
workstation and five licenses for a Sun4 workstation. 


When all available licenses for a _ particular 
application are in use, or when too few licenses have 
been purchased to run a copy of a particular applica- 
tion, the following error message is displayed: 


Sorry, no license available at this time for Xxx. 
The MAXIMUM ALLOWABLE USERS ARE USING Xxx 


Exiting. 
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Access Control automatically quits and returns you to 
the system prompt. For information about node- 
locked software or reserving licenses for specific us- _ 
ers, see Section 3. To add more licenses, contact your 
Valid representative. 
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Completing the Once installation is complete and Access Control is 

Installation functioning, you are ready to create new user ac- 
counts and configure the system for plotting and 
printing. 


See Section 4 to create accounts and Section 7 for 
information on plotting and printing. 
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Administering 
Access Control 


This section provides information about the 


administration of Valid’s Access Control. In particular, 


this section explains: 


Fault tolerant mode 

Access configuration options 
Reserving licenses 

Adding clients and servers 
Access Control Files and Utilities 


Troubleshooting Access problems 


Access Control 


Access Control 
Overview 


Starting the License 
Manager 


Access Control manages the security and the number 
of copies of an application running in a networked 
environment. With Access Control, applications are 
distributed on a first-come, first-serve basis until the 
allowed number of licenses for the application are in 
use. 


In the simplest multiple-client configuration, Access 
Control gives all users in a design group equal access 
to the-available copies of an application. You can also 
configure Access Control to reserve licenses for cer- 
tain users or machines. This section provides an over- 
view of the Access Control tool in the fault tolerant 
mode. 


Three Access Control daemons are invoked on license 
server machines and must be present for Access Con- 
trol to function properly: the license manager daemon 
(Imgrd), and the valid] and valid2 daemons. The val- 
idI and valid2 daemons distribute licenses to users of 
specific Valid applications and are managed by the 
license manager daemon. Please note that only one 
set of daemons (/mgrd, valid1, and valid2) can run on 
a license server at any given time. 


Once the server machine has been configured, these 
daemons are automatically started whenever the sys- 
tem is rebooted. The procedure for invoking the 
daemons is explained in Section 2, Configuring 
Servers. 
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The Simple Mode 


The Fault Tolerant 
Mode 


In the simple mode, one machine is a license server 
for a group of licenses. The simple mode is recom- 
mended for networks with only one file server. In this 
environment, the file server is configured as the li- 
cense server. 


In the fault tolerant mode, multiple license servers are 
chosen to manage a group of licenses that is shared by 
all servers. With redundant file servers, fault toler- 
ance provides continued access to applications when 
one of the license servers becomes dysfunctional. See 
Figure 3-1 for a diagram of a possible fault tolerant 
mode configuration. 


In both Simple Mode and Fault Tolerant Mode with 
only one Valid file server, please note that the appli- 
cations are unavailable whenever that server is down. 


License 


License 
server H1 


License 
server H2 


server H3 


(a (=) (a -_ 


Figure 3-1. Hypothetical Fault Tolerant Mode Configuration 
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In a multiple server environment, users obtain licenses 
to use Valid applications while a simple majority of the 
license servers are running. For example, with three li- 
cense manager daemons on three different servers, at 
least two servers must be functioning properly for li- 
censes to be distributed to clients. With the hypotheti- 
cal configuration in Figure 3-1, if server H1 crashes or 
is taken off-line, licenses continue to be issued from 
the remaining servers. However, if two out of the 
three servers become inaccessible, licenses are re- 
voked. 


For this reason, Valid recommends that you have an 
odd number of servers configured as license manag- 
ers. Fault tolerance is enhanced when more than an 
even number of servers are available. (You do not 
gain fault tolerance by adding a fourth server to the 
configuration in Figure 3-1, because licenses would 
be unavailable with two servers down whether or nota 
fourth server was configured.) The following table 
lists optimal configuration for fault tolerance. 


Table 3-1. Fault Tolerance 


Number of Servers Licenses Granted 
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Reserving Licenses 
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NOTE 


It is possible to reserve licenses for specific machines 
or specific users. By reserving licenses, immediate 
access to Valid’s application software is provided 
from the total pool of licenses purchased. 


To reserve licenses for a specific user, you must create 
an “options” file and add a RESERVE line for each li- 
cense to be reserved. 


In order to run one copy of a Valid application, four 
licenses are required for Sun 3 workstations and five 
licenses are required for Sun 4 workstations. For this 
reason, the RESERVE line of the options file must be 
copied four times for a Sun3 and five times for a Sun4 
to reserve the correct number of licenses. 


1 Change directories to the active license server’s 
/usr/validitools/adm directory. Login as root on 
the license server and type: 


ed /usr/valid/tools/adm 
2 Copy the template options file: 


cp options.template options 


3 Edit the new /usr/valid/tools/adm/options file 
and add the following line for each license you 
want to reserve, where feature is the application 
to be reserved and name is the specified user: 


RESERVE feature USER name 
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For example, if you want to reserve a GED appli- 
cation for user Karen on a Sun3, enter the follow- 
ing line four times: 


RESERVE ged.ex USER karen 


4 Toreserve a license for a specific machine, add 
the following line to the options file: 


RESERVE feature HOST name 


where feature is the application software to be 
reserved and name is the name of the machine 
for which you are reserving the license. 


For example, if you want to reserve a GED appli- 
cation for a Sun4 named “sunlight,” enter the 
following line five times: 


RESERVE ged.ex HOST sunlight 


> Ifyou are running Access Control ina mixed ar- 
chitecture environment, you must copy the 
edited options file on all servers and to the cor- 
responding /adm directory in the other tools 
directory (tools.sun3 or tools.sun4). 
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- Restarting the Daemons 


Once you have copied and modified the /usr/valid!/ 
tools/adm/options file to reserve the licenses, the /mgrd, 
validI and valid2 daemon entries in each license file 
must be modified and the /mgrd daemon must be re- 
started on each server. 


Complete the following procedures on each license 
server to modify and restart the license daemons. 


1 Change directories by typing: 


cd /usr/valid/tools/adm 


2 Edit the Jicense.HOSTID file and modify the li- 
cense file DAEMON entries to read: 


DAEMON validl /usr/valid/tools/bin/validl /usr/valid/tools/adm/options 


DAEMON valid2 /usr/valid/tools/bin/valid2 /usr/valid/tools/adm/options 


2/15/90 


3 Ifyou are running Access Control ina mixed ar- 
chitecture environment, copy the edited 
license. HOSTID file on all servers and to the 
corresponding /adm directory in the other tools 
directory (tools.sun3 or tools.sun4). 


4 Review the status of all Valid applications and 
determine if users are accessing a license with 
the valid_status utility. To use this utility, type: 


/usr/valid/tools/bin/valid_status -a 
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Do NOT kill the license 
manager daemon while 
licenses are in use. 


All users presently accessing a Valid applica- 
tion are listed. Please notify each user that that 
you are terminating the license manager. 


Kill the license manager daemon (/mgrd) using 
the command sequence 


ps waux | grep lmgrd 
kill -9 pid 


where pid is the process number for the /mgrd 
process. 


Restart the license manager daemon (/mgrd) on 
each license server. Type: 


/etc/rc.valid 


Use the pS waux command to verify that the 
Imgrd process is running. If the /etc/rc.valid file 
did not restart the license manager daemon, 
see Troubleshooting at the end of this section 
for instructions on restarting the license man- 
ager daemon manually. 
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Adding Servers In order to add an additional server to your existing 
environment or to update your application software, a 
new license file is required. 


When you receive a new set of tapes from Valid, load 
the new installation tape and log in as root on the 
active license server. 


1 Change directories to /usr. 


cd /usr 


2 Extract the installation script and utilities from 
the installation tape with the tar command. To 
extract this information from a 1/4-inch 
cartridge tape, type: 

tar xvfp /dev/rsto 


To extract this information from 1/2-inch tape, 
type: 
tar xvfp /dev/rmto 


3 Change directories by typing: 
cd /usr/valid/install 


4 Use the installation script to install the new 
license file. The -p option extracts only the 
license file: 


vscript -p 


5 If you are running Access Control in a mixed 
architecture environment, run vscript —-p 
again for the second set of executables. 
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6 Edit the license. HOSTID file and check to make 
sure that there is an entry for each server and 
that each entry in the license file conforms to 
the following syntax 


SERVER host_machine hostid 5200 


where host_machine is the name of the license 
server and hostid is the host ID of that machine. 


7 Verify that the new license file is available in 
the /usr/valid/tools/adm directory of each of the 
servers. In a mixed architecture environment, 
copy the new license file on each server and to 
the corresponding /adm directory in the other 
tools directory (tools.sun3 or tools.sun4). 


Valid strongly recommends If a separate installation tape for each license 
that all servers be reconfi- server was not provided, please contact your 


gured at the same time in Wei avcorccena tue 
order to avoid possible P ve. 


differences between new 
and old license file per- 8 Repeat Steps 5,6, & 7 on page 3-8 to restart the 


missions. license manager daemon (/mgrd) on each 
server. 


A new license.HOSTID file must be received from 
Valid, and the previous procedure followed, in these 
situations: 

e Adding license servers to your network 

e Removing license servers from your network 

e Changing server—client configuration 


e Adding Valid applications to your file server 
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Access Control 


Files 


The License File 


SERVER 
DAEMON 
DAEMON 
FEATURE 


FEATURE 
FEATURE 
FEATURE 
FEATURE 
FEATURE 
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This section briefly describes the Access Control files 
used to configure your system: the license. HOSTID 
file, the license.log file, the servers file, and the options 
file. 


The license file is located in the /usr/valid/tools/adm 
directory on the license server machine and contains 
the authorization codes and encryptions for all appli- 
cations managed by Access Control. 


sunrise a15328b3 5200 

validl /usr/valid/tools/bin/validl /usr/valid/tools/adm/options 
valid2 /usr/valid/tools/bin/valid2 /usr/valid/tools/adm/options 
actomd validl 1.000 31-dec-99 500 EB53E499EB2E8CCFCF4A "" 
advantage valid2 1.000 31-dec-99 500 5B13B41975599E666D54 "" 
arouter validl 1.000 31-dec-99 500 EB736449D18E43BFB268 "" 
calayV validl 1.000 31-dec-99 500 FB2334191C9E5CD39430 "" 
cif2led.ex validl 1.000 31-dec-99 500 CB23B40919DFCCDDE445 "" 
comp validl 1.000 31-dec-99 500 6BF394C9ACF93C07B348 "" 


Figure 3-2. Sample license. HOSTID file 


NOTE 


Be careful when modifying your license file. The 
server hostname and host ID on the SERVER line and 
the options file and daemon executables locations on 
the DAEMON lines are the only portions which you 
may alter. If other areas of the license file are 
changed or have become corrupted, the license man- 
ager daemon will not function correctly. This will pre- 
vent access to the Valid applications. 
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Reinstalling the License | If the license file is accidentally deleted or becomes 

File corrupted, the Valid applications cannot run. To 
reinstall the license file from the installation tape, 
login as root on the active license server and use the 
vscript installation script as follows: 


1 Change directories to /usr. Type: 


cd /usr 


2 To extract the installation script from the tape, 
use the tar command. Extract this information 
from a 1/4-inch cartridge tape by typing: 

tar xvfp /dev/rsto 
Extract this information from 1/2-inch tape by 
typing: 

tar xvfp /dev/rmto 


3 Change directories by typing: 


cd /usr/valid/install 


4 Use the installation script’s —p option to install 
the new license file by typing: 


vscript -p 


5 If you are running Access Control in a mixed 
architecture environment, run vscript —p 
again for the second set of executables. 


6 Repeat Steps 5, 6, & 7 on page 3-8 to kill and 
restart the license manager daemon (/mgrd) on 
each server. 
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If you need to change the location of the license file, 
modify the /etc/rc.valid file to include the new path to 
license file before restarting the license manager 
daemon (/mgrd). You must also edit all copies of the 
server’s /usr/valid/tools/adm/servers file and copies of 
the rc.valid file on all servers to reflect any change of 
license file location. 


The license.log File All access to the license server is logged in the /usr/ 
tmp/license.log file. Information recording checkouts, 
access denials, and network problems can be found in 
this file A sample license.log file is shown in 
Figure 3-3. 


You may want to period- Whenever the license server is rebooted, the 

ically remove old files to license.log file is automatically renamed with a 

Seven iapace: -month.day extension (for example: license.log.Nov.28) 
and a new license.log file is started. Please note that 
data accumulates in these files. 


11/28 11:42 (license daemon) FLEX]lm (v1.30) started on sunrise 

11/28 11:42 (license daemon) CONNECTED, master is sunrise 

11/28 11:42 (license daemon) Started validi 

11/28 11:42 (license daemon) Started valid2 

11/28 11:42 (validl) Server started on sunrise for: "verifier" "“ucpfsim" "tvad" 


"tscr.ex" "timemill" "thermostat" "tgilocal" "test_man" "swap" "stream2led.ex" "“ucpsim" 
"sim" "signoise" "refsim" "quanticout" "“plot.ex.color" "placement" "“pcb_review" 
"peb_prep" "pcb_engineer" "pcb_editor" 

11/28 13:47 (validl) OUT: gbom v1.000 by stu@zulu (4 licenses) 

11/28 13:47 (validl) IN: gbom by stu@zulu (4 licenses) (used: 0:00:00:01) 


Figure 3-3. Sample license.log. Nov.28 file 
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The Servers File The servers file must be present in the /usr/valid/tools/ 
| adm directory to allow access to Valid’s applications. 
The servers file must include the names of all clients 
running Valid applications and the path to the license 
file for each client. 


Entries in this file must be edited to include the re- 
quired user-specific information, according to the 
following syntax: 


clientname /usr/valid/tools/adm/license. servershostid 


Please note that if a client is not listed in the servers 
file, the default path /usr/valid/tools/admllicense.dat is 
followed. 


For procedures to create and modify your servers file, 
please refer to Editing the Template Files in Section 2. 
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The Options File The options file is located in the /usr/valid/tools/adm 
directory on the license server and is used to reserve 
licenses for specific users or machines. 


A sample options file, in which a license for Valid’s 
Graphic Editor has been reserved for user Karen ona 
Sun4 and for a Sun3 workstation named “sunlight,” is 
shown in Figure 3-4. 


# Reserve ged.ex for "karen" 
RESERVE ged.ex USER karen 
RESERVE ged.ex USER karen 
RESERVE ged.ex USER karen 
RESERVE ged.ex USER karen 
RESERVE ged.ex USER karen 


# Reserve ged for the machine "Sunrise" 
RESERVE ged.ex HOST sunlight 
RESERVE ged.ex HOST sunlight 
RESERVE ged.ex HOST sunlight 
RESERVE ged.ex HOST sunlight 


Figure 3-4. Sample /usr/valid/tools/adm|/options file 


To reserve use of a Valid application for a specific 
user or specific machine, see Reserving Licenses, page 
3-5. 
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Access Control This section provides an overview of two Access Con- 
-| trol utilities: valid_status and the valid_report. 


Utilities 
The valid_status The valid_status utility lists all current users of an 
Utility | application. It also lists the users waiting for license 


access and licenses that are specifically reserved. See 
Figure 3-5 for a sample valid_status display. 


valid_status -option 


There are three options available, individually and in 
combination, to extract the information you need: 


~a | lists all users for all applications running. Use this 
option for a complete listing. 


-| path | specifies the pathname of a specific license file; with- 
out this option, valid_status defaults to the license file 
used by your machine. This option can be used in con- 
junction with the -f option. 


-f feature | lists all users of a specific feature or Valid application. 
For a complete list of Valid Products and their corre- 
sponding feature names, see Appendix D. 


Users for the feature ged.ex are: 


karen at sunlight, started on Friday 12/15 at 11:26, 5 licenses 


Users for the feature drc.ex are: 
karen at sunlight, started on Friday 12/15 at 11:26, 5 licenses, 
gary at sunstorm, started on Friday 12/15 at 11:28, 5 licenses 


Figure 3-5. Sample valid_status display 
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The valid_report 
Utility 


-u name 


-h name 


-f name 


-P start_time end_time 
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The valid_report utility provides a complete account 
of users’ access to the various applications. By 
default, a complete list of applications, usage, time of 
access, and CPU utilization is provided for the 
specified license.log file in /usr/tmp. 


valid_report [-options] path_to_license.log 


Specific reports, containing only requested informa- 
tion, can be generated using one or more of the follow- 
ing options: 


reports prime time usage between 8am — 5pm. 


suppresses counting of duplicate entries; if more than 
one copy of an application is running on a machine at 
the same time, this option only records one copy. 
Please note this option must be entered in uppercase. 
displays the last timestamp message in the license.log 
file. 

reports all usage for a specific user. 


reports all usage for a specific host. 


reports all usage for a specified feature (Valid appli- 
cation). 

reports usage between specified times. Please note 
that this option is designated in military format, and 
provides information only for hours specified. 
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Figure 3-6 shows a sample report using the -f option 
as requested in the following valid_report request: © 


EXAMPLE 


valid report -f ged.ex /usr/tmp/license. log 


License server running from (12/15 11:28) to (12/15 11:38) 00:15:00 


FEATURE "ged.ex" of valid2 
user Requests Feature time 
name@host Granted/Denied/Queued Running / Queued 


gary@sunstornm 00:37:06/ 00:00:00 


karen@sunlight ce) 00:00:02/ 00:00:00 


Totals: 00:37:08/ 00:00:00 
Averages: 00:01:51/ 00:00:00 
Misc. info: 

20% idle time 00:03:00 

0% denied time 00:00:00 


Figure 3-6. Report Generator Utility - sample report 
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Troubleshooting If your Valid application malfunctions, investigate 
these possible problems with Access Control: 


uw Are there any error messages in the license.log 
file? 
The /usr/tmp/license.log file contains informa- 


tion concerning any errors logged by the 
valid1, valid2, and Imgrd daemons. 


a Does the license server’s servers file have a cor- 
rect entry for the malfunctioning machine? 


All entries should appear as: 


clientname path_to_license_file. 


If the entries are correct, check all mounts and 
links as described in Section 2. 


al Is the license file located under /usr/valid/tools/ 
adm and does the license server daemon know 
this location? 


Use the ps waux command to locate a lmgrd —-c 
license_file_path process — where _license_ 
file_path is the correct pathname to your 
license. HOSTID file. 


uw Is TCP/IP functioning properly? 


Refer to your Sun documentation for debug- 
ging information. 


a Is the application (for example, GED) available 
for access to an inadequate number of licenses? 
Use the valid_status utility to determine li- 
cense status. 
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Is your machine able to communicate with the 
active license server? 


To determine this, access the license server by 
typing /usr/etc/ping hostname _ where 
hostname is the name of the license server. If 
the two machines are communicating, you will 
see a message similar to: xxx is alive. If the 
machines are not communicating, this message 
appears: no answer from xxx (Or /usr/etc/ 
ping: unknown host XXX). 


Do you have the environment variable 
LM_LICENSE_FILE set? This may indicate 
possible conflicts between complimentary se- 
curity systems. 


To determine if the environment variable 
LM_LICENSE_FILE is set, type: 


printenv | grep LM_LICENSE_FILE 


If the environment variable is set, the output is: 
LM_LICENSE_FILE = path_to_license_file. When 
you have determined that this file is set, con- 
tact your Valid representative for instructions. 


Is there more than one license file indicated 
during the vscript installation process? 


If more than one /icense.HOSTID file exists on 
the installation tape, you are prompted to se- 
lect the correct file for installation. 
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al Are the valid1, valid2, and license manager 
(Imgrd) daemon running? 


Use the pS waux command to check all run- 
ning processes. If validJ or valid2 is not running, 
restart Jmgrd as described in the Configuring 
Servers, Section 2. 


a Are the Valid applications inaccessible follow- 
ing the execution of /etc/rc.valid? 


Please note that in both examples You can restart the license manager daemon 
below, the backslash symbol (\) manually by entering the following com- 
is included in the text to indicate mands. If you are running a multiple license 
a continuous command line. server configuration, this command must be 
This symbol is not entered in the 

command itself, entered at each server and run concurrently. 


InaC shell, start the /mgrd daemon with the fol- 
lowing command and substitute “HOSTID” with 
the 8—digit license file extension number: 


/usr/valid/tools/bin/Imgrd -c /usr/valid/tools/adm/license.HOSTID >& \ 
/usr/tmp/license.log & 


In a Bourne shell, start the /ngrd daemon with 
the following command and substitute “HOs- 
TID” with the 8-digit license file number: 


/usr/valid/tools/bin/lmgrd -c /usr/valid/tools/adm/license.HOSTID \ 


1>/usr/tmp/license.log 2>/usr/tmp/license.log & 
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This section explains how to add and remove users for 


the Valid software on your Sun workstation. Some of the 
topics discussed are: 


Creating new user accounts 
Assigning user passwords 
Deleting accounts 


Understanding default user files 
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Creating User Only the super-user (root) can create accounts for 
‘new users, and each account should be created on the 
Accounts machine where the user normally logs in. If you are 


running the Yellow Pages, always create the new ac- 
count on the Yellow Pages master server. 


Valid provides the mkusr utility to automate the crea- 
tion of new accounts. MWkusr adds entries to the pass- 
word and group files, creates the user’s login direc- 
tory, and then adds a set of default files for UNIX and 
Valid applications software to the user’s login 


directory. 
System The Valid software must be installed on and accessi- 
Requirements for ble from the system where you run mkusr. 


Mkusr 


To run mkusr on a Yellow Pages server, the Valid 
software must also be installed on the client system 
and the user’s home directory must be located on the 
client system. 


In this environment, Ethernet must be installed and 
running between the client and server, and the Yellow 
Pages must be running on both client and server. In 
addition, the client’s /.rhosts file must contain entries 
for the server so that the server can create the user’s 
directory on the client. 
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Running mkusr 


Press Ctrl-D to exit from 
mkusr without creating a 
new account. 
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Follow this procedure to create a user account: 


1 


2 


Log in as root. 


Type: 
mkusr 


The system prompts for the additional user in- 
formation including the user name, group 
name, the person’s full name, the filesystem 
for the user’s home directory and the default 
shell (Bourne or C). 


Enter a name for the user, such as “stuart.” If 
you enter a name in all capital letters, UNIX 
assumes that the user’s terminal can only dis- 
play all caps, which can be annoying. To avoid 
this problem, use lowercase or mixed-case 
login names. 


Enter the name of the project group for the us- 
er if you are using project groups (see Design 
File Management in Section 6.) The default pro- 
ject group name is user. 


Enter the person’s full name, such as “Stuart 
Jones.” 
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The default file system is /home. Press 


if you want the user’s home directory 


to be on the /home file system: /home/stuart. 


Enter the name of a file system (for example, 
“/homel/stuart”) if you want the home 
directory located elsewhere. 


Select the user’s UNIX shell. The Bourne shell 
is the default, and slightly faster, but the C 
shell is more versatile. Type B if you want the 
Bourne Shell. Type C if you want the C shell. 


Mkusr repeats the information you enter, and 
displays the user and group ID numbers that 
the system creates. The user ID number is a 
unique number for each user, and the group ID 
number is an encoded number for the group 
name entry. 


To add the user account, type: 


y 


If you enter y, Mkusr edits the password file 
(/etc/passwd) and group file (/etc/group), and 
adds the new information. 


If there is an error in the user information dis- 
played, type: 


n 


If you enter n, the system prompts you to re- 
enter the user information. 
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Problems Running 
mkusr 
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Next, mkusr copies the contents of the /usr/valid/tools/ 
adm/ALL directory to the new user’s directory. This 
directory contains a set of user startup files(.profile, 
login, and .cshrc), a startup.ged file, and a set of 
SCALD command (or directive) files for running the 
other SCALD analysis tools. These files are described 
in the next part of this section. 


After you create a new account, update the Yellow 
Pages password and group databases. Run mkusr on 
the Yellow Pages server if you use the Yellow Pages. 


If you create the user’s password on the Yellow Pages 
server, but put the user’s home directory on a client 
system, the user cannot log in to that client system 
unless the server and the Yellow Pages are running. 
To avoid this, you may want to create an entry in the 
client’s own password file. You can do this on the 
client with the Valid utility mknewpwentry. 


Mkusr uses mknewpwentry to create passwords. 
Simply log in as root and enter the command: 


mknewpwentry 


You are prompted for all of the necessary informa- 
tion, as shown previously for mkusr. 


If you try to create a directory on a client system but 
the client is down, Mkusr pauses and eventually times 
out with an error message. If this happens, when the 
client comes back up, log on to the client and run the 
utility that creates user directories, mkscaldusr. 
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mkscaldusr username owner group dirname 


The owner is the owner of the directory, almost always 
the same as the username. For example: 


mkscaldusr joe joe user /home/joe 


Alternatively, you can manually delete the user’s en- 
tries from the server’s password and group files, and 
then re-run mkusr on the server. 


If a user cannot log on, be sure that the Yellow Pages 
password and group databases have been updated on 
the Yellow Pages server. 


If you make a user on a diskless client, you may need 
to add the user’s home directory to the server’s /etc/ 
exports file to allow the user to access the directory. 
Also, the user’s directory (or the file system contain- 
ing it) must, in general, be mounted on the client with 
write permission. 
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Accounts Not 
Created with mkusr 
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Mkusr chooses user ID numbers based on login 
names. If you have two users on your Ethernet with 
the same login, they will receive identical user ID 
numbers. Consequently, even if they have accounts 
on different systems, they may be able to gain access 
to each other’s files without knowing the other per- 
son’s password. This may be a problem if you are ina 
security-conscious environment. To fix the problem, 
change one of the user’s ID numbers by editing one 
user’s password file entry on the Yellow Pages server. 
If the user also has a password file entry on the user’s 
own system, change that password file entry as well. 


Users with accounts not created by mkusr, especially 
root, must add the directory /usr/valid/tools/bin to their 
search path in order to use the Valid software. This 
requires changes to the ./ogin and .cshrc files (C shell) 
or to the .profile file (Bourne shell). Examples of 
these files containing the correct path can be found in 
the directory /usr/valid/tools/adm/ALL. 


Copy the Valid SCALD software startup files 
(startup.ged, etc.) in /usr/valid/tools/adm/ALL to the us- 
er’s home directory. Be careful not to overwrite the 
user’s existing ./ogin, .cshrc, or .profile files with the 
generic versions in the ALL directory, since the user 
may have customized them. Make sure that each us- 
er’s path variable gets changed, either by you or by 
the user. 
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New users should set their passwords with the 
passwd command and/or the yppasswd command 
(if you are running the Yellow Pages) the first time 
they log in. 


The exact procedure depends upon whether you are 
running the Yellow Pages and whether the user has a 
password file entry on the YP client system as well as 
on the YP server. 


The procedure each user should follow is: 


1 Log in to the YP server or to a client and enter 
the yppasswd command: 


yppasswd 


2 The system prompts for a password. Type ina 
password. The password is not echoed on the 
screen. 


3 The system asks the user to repeat the pass- 
word to guard against typing errors. Retype 
the password. The system then updates the 
Yellow Pages server’s password database with 
the encrypted version of the new password. 


If the user also has a local password file entry 
on a YP client, the user should log in to that 
client and enter the command: 


passwd 
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The system prompts for a password. (Users can have 
different passwords on their home system and on the 
rest of the network.) Type a password at the prompt, 
and repeat it when prompted to do so. 


Users can change their passwords with the passwd 
and yppasswd commands whenever they like. 


If there is no password entry for a user’s account, the 
system does not demand a password when someone 
logs in with that user name. 
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Forgotten 
Passwords 
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Root can change any user’s password with the 
command: 


passwd username 


When users forget their password, you can give them 
a new one with the passwd command. Since the yp- 
passwd command does not let root change other us- 
er’s passwords unless root knows their current pass- 
word, you’ll need to use the passwd command on the 
YP server and then update the YP password database. 


If you forget the root password, rlogin from a machine 
listed in your /.rhosts file and change the root pass- 
word to one you can remember. 
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Removing Users | Follow this procedure to remove a user from the 
system: 

1 Delete the line containing the user’s name 
from the /etc/passwd file on the Yellow Pages 
server and on any clients where the user has 
password file entries. 


2 Delete the user’s name and the trailing comma 
from the /etc/group file on the YP server and all 
clients where the user had password entries. 


3 Rebuild the yP password and group databases 
on the YP server. 


4 Archive the user’s directory to tape. 


5 After creating the tape, determine which of the 
user’s files you should keep on hand, and copy 
them to other directories. 


6 Delete the user’s login directory with the rm 
command using the -r option. For example: 


cd /home 
pwd — check that you’re in the right place 
rm -r suzy 


NOTE | The -r argument to 7m recursively removes /home/suzy 
and all the files and directories it contains. Be ex- 
tremely cautious with the rm -r command. You 
don’t want to accidentally remove everything in /home! 
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Default User This section describes the default files that mkusr puts 


Files 


e login e 
e .cshrc e 
e profile e 
© compiler.cmd e 
e packager.cmd e 


into each new user’s home (login) directories. 


simulate.cmd 
startup.ged 
td.cmd 
verifier.cmd 
master.local 


The Is command does not list the files that begin with 
a dot (.) unless you use the -a flag. 


All of these files except for .login, .profile, and .cshrc 
are for the Valid SCALD applications tools, and are 
described in the various SCALD reference manuals. 
These three “dot” files customize the user’s UNIX en- 
vironment when logging in or starting up a shell. 
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The login File The system reads a user’s .login file whenever the user 
logs in under the C shell. The file contains commands 
that set up the shell environment for the user. The 
default .Jogin file is shown in Figure 4-1. 


# rcsid[]="$Header: .login,v 800.1 85/09/12 15:05:23 root Exp $"; 
# sccsid[]="%wW% 2Y% %Q% %G%"; 


setenv MAIL /usr/spool/mail/$USER 


Figure 4-1. Default .login File 


The first two lines are comments that identify the revi- 
sion level of the file. 


The setenv command sets the MAIL variable that 
determines the file in which the user’s mail is 
spooled. 
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The .cshrc File The system reads the .cshrc file whenever a C shell is 
started for the user. Unlike the -Jogin file, which is 
read only once (when the user logs in), the .cshrc file 
is read each time a sub-process is started. When you 
log in, the system reads the .cshrc file first, and then 
the .login file. Consequently, the value set for PATH 
(or any other variable) in the .Jogin file overrides the 
value in .cshrc. Figure 4~2 shows the default .cshrc 
file. 


# rcesid[]="$Header: .cshrc,v 800.1 85/09/12 15:05:19 root Exp $"; 

# sccsid[]="%wW% %ZY% %Q% %G%"; 

set path=(~/bin /usr/local /usr/ucb /usr/bin /bin /usr/valid/tools/bin .) 
set mail=/usr/spool/mail/$USER 

if ($?prompt) then 


# this is login shell 
set ignoreeof 
set history=20 

endif 


Figure 4-2. Default .cshrc File 


The first set command sets the user’s search path. 
The second set command specifies the file in which 
the user’s mail is spooled. 


The if... endif checks whether the variable “prompt” 
is set. If it is, the login shell is being initialized and 
the two set commands are executed. 
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The variable “ignoreeof” is set to cause the system to 


ignore end of file characters ((Gontro))-D) so that 
pressing (ontrad) -D does not log the user out. 


The value of “history” is set to 20. The C shell history 
mechanism keeps track of the last 20 commands this 
user has entered, and allows the user to repeat them 
with or without modifications. See the csh man page 
for more information. 
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The .profile File The system reads the .profile file in a user’s top direc- 
tory whenever the user logs in under the Bourne shell. 
Figure 4-3 shows the default .profile file. 


# rcsid[J="$Header: .profile,v 800.1 85/09/12 15:05:27 root Exp $"; 
# sccsid[]="2W% ZY% %ZQ% %G%"; 
MAIL=/usr/spool/mail/$USER 


PATH=: /usr/$USER/bin: /usr/local: /usr/valid/tools/bin: /usr/ucb: /usr/bin: /bin 
PS1="% " 
export HOME USER PATH MAIL TERM PS1 


Figure 4-3. Default .profile File 


The PATH must be on a single line. 


The MAIL and PATH variables are set as explained for 
the .cshrc file. 


The PS1 variable, the primary prompt, is set to display 
% ’. 


The export command makes the HOME, USER, PATH, 
MAIL, TERM, and PS1 variables global to the user’s 
shell and available to any program or command the 
user executes. 
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This section reviews procedures for backing up and 
restoring design data. 


Backups 


The most valuable part of your Sun Workstation is 
the data created by your users. To facilitate the task 
of maintaining backup copies of their design data, 
this chapter reviews your standard backup utilities. 


This material is intended to be a supplement to the 
Backup and Restore sections of System Administration 
for the Sun Workstation that came with your 
workstation. 


The exact procedure for backup depends upon sev- 
eral factors at your site, including the number of sys- 
tems involved, the responsibilities of your System 
Manager, and your site’s policy regarding backups. 
Choose the procedure that works best for you, but be 
sure to check that you can actually restore from the 
backup tapes you make. 
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Utilities for 
Backups: 
Overview 


tar: tape archiver 


cpio: copy input to output 


custombkup 


cronbkup 
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UNIX provides several utilities that can be used for 
backing up and archiving files. For specific informa- 
tion on command syntax, see the appropriate UNIX 
manual page. In addition, Valid supplies three utili- 
ties: backup (8V), custombkup (8V), and cronbkup 
(8V). Below are brief descriptions of these utilities. 


This is the easiest backup utility to use. Incremental 
backups are difficult with tar, but if you want a full 
backup of a small user file system or a design direc- 
tory, or if you just want to backup a few specific files, 
tar is very convenient. Tar is also the best utility for 
users who want to make backup tapes themselves. 
Because tar does not support multi-volume tapes, 
backups of large files or file systems must fit on a 
single tape. Tar is the most portable backup UNIX 
utility. A user has the best chance of moving a file 
between different vendors, such as SunOS, SCALD 
$320, and ULTRIX with the tar format. 


This utility is good for incremental backups of design 
directories or file systems. The syntax is complex, 
but useful. 


This utility is an interactive front end to cpio that cre- 
ates full or incremental back-ups of directory trees. 
Use custombkup to backup part of a file system. 


This utility is a script file that performs automatic 
cpio backups of directory trees to a remote server- 
disk. Cronbkup is executed by the cron daemon from 
the crontab file. 
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This utility creates full or incremental dumps of entire 
file systems. Dump supports multi-volume tapes. 
Use restore to read a dump tape. 


This utility is an interactive, front end for dump that 
backs up every file system on each of your system’s 
disks. 


This is the generic UNIX copying utility. It can be 
used to read and write tapes for non-UNIX systems. 
For example, the block size and the order of data in 
bytes may be different, or the other system may use 
the EBDCIC rather than the ASCII data format. The dd 
utility can handle these types of conversions. How- 
ever, the dd utility is not very convenient for making 
system backups, and, like tar, is limited to a single 
tape. 
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Sample Backup Figure 4-1 is an example of a session using backup. 
Session 


Do you want to back up to: 


1) a local tape device 
2) a remote tape device 
3) a file in a remote file system which is currently mounted via NFS 


[local|remote|file]: local 
Is UNIX running single user? [y|n]: y 


Do you wish to check the file systems? [y/n]: y 
{normal fsck messages} 


The "dump" program with the "9u" option will now be used to back up all 
the files created or changed since the last daily, weekly, or monthly 
backup. 


Daily backup (dump 9u) of /dev/rsdOg (/usr) 


What is the path name of the file you want to backup to? 


/nfs/sudan/mnt/backups/kenya/dailyusrmonday 

Type <ctrl>D when tape is loaded and on line 

*D 

DUMP: Date of this level 9 dump: Mon Apr 20 17:39:42 
DUMP: Date of last level O dump: the epoch 

DUMP: Dumping /dev/rsdOg (/usr) to 
/nfs/sudan/mnt/backups/kenya/dailyusrmonday 

DUMP: mapping (Pass I) [regular files] 

DUMP: mapping (Pass II) [directories] 

DUMP: estimated 6620 tape blocks on 0.34 tape(s). 
DUMP: dumping (Pass III) [directories] 

DUMP: dumping (Pass IV) [regular files] 

DUMP: estimated 49437 tape blocks on 0.14 Lape tay: 


Figure 4-1. Daily Backup to Remotely-Mounted System 
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The easiest way to restore a few files is to use restore 
with the i flag. This flag tells restore to read the direc- 
tory information on the tape (or on the first tape, if it 
is a multi-volume backup) and then create a shell- 
like environment in which you can examine the 
directories and files. See restore in the UNIX 
Reference Pages for more information. 


The basic procedure to restore individual files 
follows. 


1 Bring the system down to single-user mode 
and run a file system check. 


2 Mount the tape for the file system that contains 
the file you want. If the file system spans sev- 
eral tapes (volumes), mount the first tape 
(volume 1). 


3 Use cd(1) to change the working directory to 
be the same as that of the mounted file system 
(for example: cd /usr). 


4 Enter the appropriate command: 


restore iv 

{For local 1/4 inch cartridge tape} 
restore ivf [host:]/dev/rmt0 

{For 1/2 inch remote tape device} 
restore ivf filename 

{For remote dump file mounted via NFS} 
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The | flag sets up the interactive shell, and the 
Vv flag tells restore to be verbose. The f flag 
Says to use an input device other than the de- 
fault, /dev/rstO. The optional host argument 
reads a tape in a remote system’s tape drive; 
your system must be in the /.rhosts file on the 
remote system. 


5 The system displays a series of messages, 
reads the directory information, and then dis- 
plays a prompt: 


verify tape and initialize maps 
Dump date: (date tape was made) 
Dumped from: (date of previous dump) 
Extract directories from tape 
Initialize symbol table 


restore> 


6 From the restore> prompt, you can use the 
cd, pwd, and /s commands to move through 
the directory tree and list the names of the 
files. While in this shell-like environment, / is 
the top directory of the file system you backed 
up (for example, /usr/joe becomes /joe). 
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Use the add command to select a file for 
extraction: 


restore> add filename filename2... 


The selected file is marked for extraction. 


After selecting the files and directories you 
want, use the extract command to extract the 
files from the tape: 


restore> extract 
The system responds: 


Extract requested files 

you have not read any tapes 
yet. Unless you know which 
volume your file(s) are on, 
you should start with the 
last volume and work towards 
the first. 


Specify next volume #: 
Enter the tape number. If there is only one 
tape in the backup, type: 


1 


If there are several tapes and you don’t know 
which tape contains the file(s), load the last 
volume into the tape drive and then enter its 
number. 
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11 
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The system extracts the files. When finished, 
the system prompts: 


Set directory mode, owner, 
and times. Set owner/mode 
for *.’ [yn]: 


Answer “y” if you want to restore the original 
ownership and permissions. Answer “n” if 
you want the restored files to be owned (and 
have the default permissions of) the person 
running restore. 


The restore> prompt reappears. You can 
select more files or exit from restore with the 
quit command. 


Backups 


Restoring Entire File 


Systems 
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NOTE 


To recover a lost user file system, you must rebuild 
the file system using newfs and then restore the files 
onto the clean file system. Even if the file system you 
are restoring has not been totally destroyed, you 
should use newfs to get a clean disk with contiguous 
files. 


Do not restore a file system unless you are running 
in single-user mode. 


Restore your full backup first, and then each neces- 
sary incremental backup, working from the oldest 
tape to the newest. Valid recommends the following 
backup procedures: first restore the most recent full 
(monthly) backup, then the current weekly backup, 
and finally, each of the daily backups, beginning with 
the oldest. | 


Everything in the file system is irretrievably deleted 
when you run newfs. Always backup the entire file 
system with Gump or rdump before rebuilding it. 
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To restore a full file system, follow this procedure: 


1 Bring the system down to single-user mode. 
Halt all diskless clients if the system is a Net- 
work Disk server. You can do this by reboot- 
ing the server. 


2 Rebuild the file system with the newfs 
command: 


/etc/newfs /dev/rdevice 


where device is the name of the disk partition 
(for example, xy2h). Newfs is a front-end to 
mkfs that uses disk partition information 
stored in the file /etc/disktab. This command 
essentially says, “erase this file system and 
make a new file system with all blocks free.” 


3 After running newfs, check the new file 
system: 


/etc/fsck -y /dev/rdevice 


4 Mount the file system: 
/etc/mount /dev/device filesystem_name 


For example: 


/etc/mount /dev/device /home 


5S Change directory to the top directory of the file 
system: 


cd /home 
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6 Load the first volume (tape 1) of the most re- 
cent full (monthly) backup into the tape drive. 


7 Restore the file system with the appropriate 
command: 

restore rv 

{For local 1/4 inch cartridge tape} 
restore rvf [host:]/dev/rmt0 

{For 1/2 inch remote tape device} 
restore rvf filename 

{For remote file mounted via NFS} 


The system asks you: 


Set directory mode, owner, 
and times. Set owner/mode 
for *.’ [yn]: 


8 Answer “y” if you want to restore the original 
ownerships and permissions. Answer “n” if 
you want the restored files to be owned (and 
have the default permissions of) the person 
running restore. You probably want to restore 
the original information. 


9 After restoring all volumes of the monthly 
backup, repeat the restore command for the 
most recent weekly backup, and again for each 
of the daily backups, beginning with the oldest. 
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10 Change to the root directory: 


cd / 
11. Dismount the file system: 


The -a option unmounts /etc/umount -—a 
all files. 


12 Run a file system check on the restored file 
system: 


/etc/fsck /dev/name 


13 Bring the system backup to multi-user mode 


by entering (Contr) -D. 


This should leave you with a restored file system that 
is complete to the time of your last backup. 
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The tar Utility 


Tar is the tape archive utility for writing multiple files 
or directories to a single magnetic tape or restoring 
multiple files from a single magnetic tape. The tar 


utility 


operates on individual files and directories 


rather than entire file systems and can be used both to 
read and to write tapes. Tarrecursively follows direc- 
tory trees to the bottom of the directory hierarchy. It 
can therefore be used to archive entire directory trees. 


Tar is 


relatively simple and has a number of uses: 


Tar is used for backing up user files and 
application programs when updating your sys- 
tem to a new release. 


Tar is used for backups of individual files and 
directories. 


Designers who want to make a backup tape for 
themselves often use tar. 


Designers who need to maintain their own tape 
archives often use tar. 


not very useful for incremental backups be- 


There is no way to tell tar not to overwrite files 
that have been changed since the tape was cre- 
ated. 


Multi-volume archives are impossible to 
create because tar does not recognize the end 
of the tape. 


Tar is relatively slow for archiving or restoring 
large numbers of files. 
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The tar command has several options, or “flags.” 


creates a new archive on tape or write tapes. This flag 
will cause tar to write at the beginning of the tape. 
Please note that the c option will overwrite any previ- 
ous files that may exist on the tape. 


extracts files or directories from tapes. 


tells tar to be verbose. This means that tar will print 
the name of each file that it reads or writes, together 
with the file’s size in bytes. By default tar does not tell 
you which files it has selected. 


displays the names and other information on the tape 
without loading the files. The user is encouraged to 
check the contents of a tape before loading it in order 
to avoid overwriting a more current version of a file. 


specifies the name of the archive tape device instead 
of the default /dev/rstO and is used in most situations 
requiring tar. 


The example below creates an archive to the default 
tape drive (/dev/rst0): 


tar cv filename 


To append the file or files to the end of an existing 
archive tape, use the r option, as follows: 


tar rv filename 
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Using a period (.) after 
the tar command places 
the restored files in your 


present directory location. 


If you give tar a full pathname for a file or directory as 
you create the tape, that file or directory is restored to 
its original directory regardless of the directory loca- 
tion when you read the tape. This kind of tape is 
known as a “rooted” tar tape. 


The example below creates a rooted tape: 
tar cvf /dev/rstoO /home/sue/projl 


If you want to tar several files on one tape, you must 
use the device file nrst0 as the device. This file stops 
the tape at the end of the tar cycle without rewinding 
the tape, and is used as follows: 


Often you do not want to restore files to their original 
directories. For example, when archiving a design 
directory, you may want to restore it to a different 
directory later. To create an “unrooted” tape, change 
to the directory containing the files or directories you 
want to archive and use a period (.) to represent the 
pathname. To create an “unrooted” tape, the tar 
command is entered as follows: 


cd /home/stuart/projectl 
tar cvf /dev/rsto . 
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NOTE 


The period (.) tells tar to archive both the current di- 
rectory and each of its files and subdirectories. The 
advantage of an unrooted tape is that you can restore 
the files to any directory you choose. The disadvan- 
tage is that, if you do not move to the correct directory 
before reading the tape, you might restore the files in 
the wrong directory. 


The following example shows how far is used to read 
the contents of an unrooted tape into a user’s direc- 
tory. 


cd /home/stuart/projectl 
tar xvf /dev/rsto 


When unrooted files are extracted, file ownership is 
automatically transferred to the directory’s owner. 
This can be helpful when you want to change the own- 
ership of a directory tree. Rooted files retain their 
original ownership. In order to retain the original 
ownerships and protections, use the p flag. 


Tar works with file systems rather than the raw disk. 
Accordingly, tar is significantly slower than the dump 
and restore utilities. Also, the messages printed by 
the v flag further decrease tar’s speed. 


Design File 
Management 


This section describes the files and directories that 


make up a Valid SCALD design project on a Sun 


Workstation. In particular, this section explains: 


Oo 


Organizing files into design directories 


Protecting designs using UNIX file 
permissions 


Using SCALD directories and SCALD libraries 
Maintaining the user file systems 


Archiving a design 
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Figure 6-1. Directory Hierarchy 


Figure 6-1 shows where the Valid software and 
libraries are located, and how design project 
directories are arranged. 
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Design The files used in a design need to be organized in or- 
3 , der that users can easily find the files they need, have 
Directories permission to change the appropriate files, and are 


denied permission for files they shouldn’t change. 
For these reasons, it is best to keep all of the drawings 
that make up a design in a single design directory. This 
directory can be the login directory for an account you 
For more information on create for the design. The sub-directories that GED 
file permissions, see File creates in a design directory, which contain the files 
Permissions, page 6-10. for individual drawings, are called drawing directories. 
Figure 6-2 displays a sample design directory. 


pee 
1 UNIX file 


myproject 


myproject.wrk startup.ged 


compiler.cmd 


Figure 6-2. Sample Design Directory 
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Simple Project 
Account Security 


Strict Project 
Account Security 
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To set up the design directory, run mkusr and give the 
project name as the user name. This creates a UNIX 
directory for the project. 


All users working on an individual project can log in 
with the project name. A project account allows each 
member of the group convenient access to, and write 
permission for, the files in the design. There are two 
disadvantages to project accounts: problems can oc- 
cur when two users try to simultaneously access the 
same command or data files. With this approach, 
there is also a lack of password confidentiality. 


A second, more secure approach, and one that re- 
quires more work from the System Manager, is to cre- 
ate the design directory as indicated above, but have 
each user log in with their own user name, instead of 
the project name. 


For this approach, the System Manager must change 
the default file permissions on the design directory 
files. By default, only the user who creates a drawing 
has write permission on that drawing’s files and in 
that drawing’s directory. Anybody can copy the draw- 
ing to their own directory, or use it unchanged from 
the original directory, however, they cannot modify it 
unless they first copy it. Problems can occur when 
several different users need to have write permission 
in the same directory. 
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Separate access can also limit user capacity to run the 
Logic Simulator, Timing Verifier, or Packager on 
drawings they do not “own.” If everyone on the sys- 
tem is given write permission, this may solve the per- 
mission problems, but the security problem remains. 


A safer solution to the file permission problem is to 
assign the people working on a project to a group (by 
modifying the /etc/group and /etc/passwd files), and 
then give write permission in the design directory only 
to that group. 


Figure 6-3 shows how this arrangement works. The 
figure shows the top directories for users ken, pam, 
joe, and toaster, who belong to the project group 
“toast.” Ken, Pam, and Joe would have the command 
use /home/toaster/toaster.wrk in their startup.ged 
files in their home directories. 
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UNIX 
directory 


UNIX file 


toaster.wrk  startup.ged 


/etc/group entry: 
toast: :25:ken,pam, joe, toaster 


everyone’s startup.ged entry: 
use /home/toaster/toaster.wrk 


Figure 6-3. Project Account Directory 


For more information on The following procedure explains how to set up file 


file permissions, see File 
Permissions, page 6-10. 


protections so that the members of a project group, 
and no one else, can modify the group’s files. 


1 Edit the /etc/groups file and create groups for 
each of your project teams. Pick unique group 
ID numbers for each group. Do not use group 
ID 0; this is the ID for the group containing 
root, sys, and other privileged users. 
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Avoid using group ID 10, which is the default 
“user” group. See mkusr in the Valid supple- 
ment to the UNIX manual pages for more in- 
formation. Do not use group passwords; they 
are a potential security loophole. 


For a group designing three different pro- 
jects, the /etc/group file might look like this: 


wheel: *:0: 

daemon: *:1: 

kmem: *:2: 

bin: *:3: 

news:*:6: 

lib: *:8: 

staff:*:10: 

other: *:20: 

user: :2791:fe,scald,user 
proj1i::20:gary,joe,pam,mary 
proj2::21:carol,lee,stuart 
proj3::23:paula,kevin, hubert 
$2 0% 


Edit the /etc/passwd file with viow and change 
each user’s group ID number as necessary. 
Carefully check the file format. Then rebuild 
the Yellow Pages password database. 


Add the command umask 002 to each group 
member’s .Jogin and .profile files. This gives 
the group write permission for new files and 
directories created by users in the group. 
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Add the umask 002 command to the default 
login and .profile files in the directory /usr/ 
valid/toolsiadm/ALL. These are files provided 
to all new users when accounts are created. 


Change the file permissions on the existing 
files that the groups will share. To do this, use 
the commands 


chmod 664 filename 
and 
chmod 775 dirname 
to set permissions on files and directories. 


The chmod command accepts. wildcard 
arguments. 


When you create accounts for new users, 
assign them to the proper existing or new 
group. 


Instruct all users to work in subdirectories of 


their own login directories, not in the project 
account’s directory. 


2/15/90 


Design File Management 


Using chmod 


2/15/90 


You can use the find command to recursively search a 
directory tree and execute chmod on all of the files 
and directories. The C shell command 


find . -type d -exec chmod 775 {} \; 


recursively changes the permissions on all directories 
under the current directory. The C shell command 


find . -type f -exec chmod 664 {} \; 


recursively changes the permissions on all regular 
files under the current directory. Warn your users 
that they must restore execute permissions on any 
files that should be executable in the directory trees 
you modified. 


Files and directories should have the following per- 
missions: 


drwxrwxr-x 19 ken 512Nov 14 17:20 Mydir 


-rw-rw-r-- 1 ken 7135Nov 14 10:55 Myfile 
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Read permission 


Write permission 


Execute permission 


File permissions are used to prevent users from gain- 
ing access to files that they are not authorized to read 
or modify. 


By default, any user can read any other user’s files. 
Also by default, only the “owner” of a file (the person 
who created it) can edit or delete the file. The default 
permissions for new files are set with the umask com- 
mand. As you have already seen, permissions on ex- 
isting files are changed with the chmod command. 


Each file and directory in UNIX carries a three-digit 
octal code that defines read (r), write (w), and 


wenw weeuw a essaurvewaawe 


Allows you to look at the file names in a directory 
(with /s) or the contents of a file (with more). 


Allows you to edit a file (with vi) or delete a file (with 
rm). Write permission for a directory allows you to 
write files into the directory or delete files from that 
directory. 


Allows you to execute the file as a program. Execute 
permission on a directory allows you to Cd to the di- 
rectory and to specify it in path names. 


Only a file’s owner, or the super-user (root), can 
change the permissions on a file. However, the owner 
of a directory can override the permissions on any file 
in that directory regardless of the file’s ownership and 
its subsequent permissions. 
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Default Permissions 


Group Permission 
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The three permissions — read, write, and 
execute — are specified for three different types of 
users: the owner of the file, the owner’s group, and 
everyone else. 


To examine the permissions on a file or directory, use 
the Is -l command. For example, listing a user’s 
name directory would show a Startup.ged file similar 
to: 


-rw-r--r-- 1 steve 4659 Aug 5 09:12 startup.ged 


The entry shows that the file has standard default per- 
missions: its owner (steve) can read, edit, or delete 
the file. Anyone else can read but cannot edit or de- 
lete the file. If this file was a program, no one could 
execute it without steve or root first changing the exe- 
cute permission on the file. A directory entry for such 
a program would be similar to: 


drwxr-xr-x 7 steve 1024 Sep 16 15:11 projectl 


This entry shows the default permissions on a direc- 
tory. The d in the first column identifies the file as a 
directory. The owner (steve) can read or write files in 
the directory and list the contents of the directory. 
Anyone else can Cd to the directory and list the files in 
the directory, but they cannot write new files into the 
directory or change any files. 


By default, all users belong to the same group. The 
group memberships on your system are listed in the 
file /etc/group, which you can modify with vi at any 
time. — 
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To provide members of a group unrestricted read and 
write access to files while restricting access to users 
outside the group, include the following umask com- 
mand in each group member’s .login file: 


umask 007 


With this umask value, files and directories are 
created with the following permissions: 


—-rw-rw----— 
drwxrwx--- 


To change existing files to match these permissions, 
use both of the following chmod commands: 


chmod o-rwx filename 
chmod g+w filename 


If read permissions are allowable to users outside the 
group, yet they are not allowed to write or delete those 
files, use umask 002 rather than umask 007. 
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Strict Permissions 


Permissions for 
Programs and 
Scripts 
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In order to prevent anyone but a file’s owner from 
reading or modifying a file, use chmod as follows: 


chmod og-rwx filename 


If you want to apply this permission to all new files 
created by a specific user, put the following umask 
command in the user’s .login file: 


umask 077 


Files and directories will have the following 
permissions: 


Valid applications software is stored in directories for 
which all users have read and execute permissions, 
but not write permission. Similarly, most of the 
SCALD and UNIX programs can be read or executed 
by anyone. There are a few powerful programs, such 
as shutdown, which can only be executed by root. 


If you create shell scripts or particular programs for 
your users, remember to give them execute permis- 
sion for those files. To do so, use the following com- 
mand: 


chmod uog+x filename 
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Special Permissions 


Set-user-ID Permission 


Set-group-ID Permission 


The Sticky Bit 


In addition to the three permission “bits” described 
previously, there is a fourth bit that allows special per- 
missions: set-user-ID permission, set-group-ID per- 
mission, and the “sticky bit.” While it is unlikely that 
you will need them, a brief review follows: 


A set-user-ID program temporarily sets the user ID of 
the person executing the program to that of the pro- 
gram’s owner. Several system programs require root 
privileges so that ordinary users can perform neces- 
sary tasks with that program. An Is -I of a file with 
this permission looks like this: 


-rwsr--r-- 7 root 1024 Sep 16 15:11 mycode 


Set-group-ID programs work much the same way: the 
person executing the program temporarily carries the 
group ID of the program’s owner. An Is -1 of a file 
with both set—user-ID and set-group-ID permissions 
looks like this: 


-rwsr-sr-- 7 root 1024 Sep 16 15:11 mycode 


Setting the “sticky bit” causes the system to save a 
program’s image in the swap area on the disk. It also 
shortens the amount of time required to read fre- 
quently—used programs, such as vi. Be careful to set 
this permission only as necessary; setting this bit on 
several programs can quickly fill the swap space and 
slow system performance. The sticky bit permission 
looks like this: 


-Trwxr-xr-t 5 root 153886 Jan 2 86 /usr/ucb/vi 
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Understanding A SCALD directory is a file that maps names given to 

drawings by users to their corresponding UNIX direc- 
SCALD tories. By convention, a SCALD directory file ends 
Pirectories with a .wrk extension. 


SCALD directories are automatically created and up- 
dated by the Graphics Editor (GED). 


There should only be one SCALD directory in each 
UNIX design directory. More than one makes it diffi- 
cult to keep track of which drawings belong to which 
SCALD directory. 


While users are cautioned against modifying the con- 
tents of their SCALD directories, if a SCALD directory 
file is accidentally deleted or altered, you may be re- 
quired to edit a user’s SCALD directory file to correct 
or resolve the situation. Figure 6-4 shows a sample 
SCALD directory. 


FILE TYPE = LOGIC_DIR; 

"UNIX INODES" “’unixinodes’; 

"SYSTEM BOOT PROC" “’systembootproc’ ; 
"ETHERNET" “’ethernet’; 


"UNIX INODE STRUCTURE" ‘’nxndestrcture’; 
"BACKPANEL" “’backpanel’; 
END. 


Figure 6-4. Sample SCALD Directory 


The first line of the file is the file type. Unless you are 
doing library development work, the file type is al- 
most always LOGIC_DIR. The last line must be 
“END.” 
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NOTE 


Each entry in the file maps the name given to a draw- 
ing in GED with the name of the corresponding UNIX 
directory. 


The UNIX directory name is derived from the drawing 
name according to the following rules: 


e All upper case letters are converted to lower 
case. 


© Spaces and special characters are deleted. 


e The name is abbreviated to 14 characters by 
eliminating vowels. 


According to these rules, the drawing named “UNIX 


INODE STRUCTURE” described in Figure 6-4 is 
mapped to the UNIX directory “nxdestructure.” 


If you must add an entry to a SCALD directory with vi, 
be careful when naming directories. Make sure that 
the real UNIX directory name matches exactly the 
name placed in the file. 
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Accessing 
Drawings Over 
the Network 


NOTE 
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The System Manager, as super-user (root), can 
mount a remote design directory on the local ma- 
chine. Remote mounting allows access to the draw- 
ings on another system as though they were actually 
on the local disk. There are two system requirements 
for mounting a remote design directory: both ma- 
chines must support NFS, and you must be logged in 
as root. 

The /etc/exports file on the remote machine controls 
which file systems can be mounted. The design direc- 


tory you want to mount must be listed in the server 
machine’s /etc/exports file. 


If you find yourself executing the same mount com- 
mand frequently, include a mount entry in your local 
/etc/fstab file. 


The following procedure explains mounting a remote 
directory: 


1 Create an empty directory, using mkdir, on 
which to mount the remote directory. 


2 Use the mount command to mount the remote 
directory. 


To mount a remote directory from a machine 
named “hegel” to a directory named /home2/proj4, 
type: 


mount -o soft hegel:/home/joe/proj4 /home2/proj4 


The -o soft option prevents the system from halting if 
the remote machine goes down. 
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Libraries and File 
Permissions 


In addition to those supported by Valid, libraries can 
include your company’s standard borders, in-house 
libraries, standard cell libraries, or any other set of 
drawings or cells to which your users need quick, 
read-only access. 


SCALD libraries for parts, drawings, or cells are struc- 
tured like SCALD directories. By convention, library 
SCALD directory names end in .lib. 


The use of a “master library” file makes libraries 
more convenient to use than SCALD directories since 
users do not have to specify the path to the library 
directory. For example, it is much easier to type lib 
Isttl than it is to type the full command lib /usr/valid/ 
lib/sttiAsttl.lib. 


In a networked environment, a library server provides 
convenient, transparent access to component parts 
via NFS. Remotely mounting libraries allows any 
number of systems to share a single set of libraries 
rather than using important disk space on each indi- 
vidual system. 


Library directories and the files below them should be 
owned by the user “Jib.” These library files and direc- 
tories are write-protected against all other users. In 
order for the Valid application programs to use a li- 
brary, the parts must be owned by /ib, and lib must 
have write-permission in the subdirectories for each 
part. In order for an application program to use a 
remote library, local user “Jib” must have rsh privi- 
leges on the remote machine. 
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The Master Library The system maps library locations to alias names in 

File the file /usr/valid/lib/master.lib. When you install a 
new library with vinstall, the master library file is up- 
dated automatically. However, if you add libraries of 
your own, you will need to add entries to this file. A 
sample master.lib file is shown in Figure 6-S. 


file type = master_library; 

‘sim’ ’/usr/valid/lib/sim/sim.1lib’; 

‘time’ ’/usr/valid/lib/time/time.1lib’; 

“standard’ ’/usr/valid/lib/standard/standard.1lib’; 
‘phantom’ ’/usr/valid/lib/phantom/phantom.1lib’; 


‘help’ ’/usr/valid/tools/editor/doc/help.wrk’ ; 
‘spice’ ’/usr/valid/lib/spice/spice.lib’; 
‘tutorial’ °’/usr/valid/lib/tutorial/tutorial.lib’; 
end. 


Figure 6-5. Sample master.lib File 


The first line of the file specifies the file type. The 
last line must be “end.” Each entry in the file has: a 
quoted alias, beginning in the first column, one or 
more spaces, a quoted UNIX pathname to the library’s 
SCALD directory, and a semicolon terminator. Please 
note that you must use quotation marks (’) as indi- 
cated, not the grave accent (‘). 
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Mounting Valid 
Libraries 
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NOTE 


Mounting Valid libraries from a server is essentially 
the same as mounting any file system. The only addi- 
tional consideration occurs when the libraries are lo- 
cated in different directories on the server and client. 
On a Sun Workstation, libraries are logically located 
in /usr/valid/lib. 


When mounting libraries on either identical directory 
structures or dissimilar directory structures, the fol- 
lowing general rules should be considered: 


e Keep the library directory structure intact. The 
installation program (vinstall) installs libraries 
at designated directory locations. See Valid 


Software on Servers in Section 2 of this manu 


a 
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for more information. 


e Minimize the number of mount points and 
symbolic links to simplify system management 
and make NFS easier to use. 


When mounting libraries on dissimilar directory 
structures, you must also maintain the master.lib file 
on the client. The master.lib file, as demonstrated in 
Figure 6-5, is referenced by several Valid 
applications. 
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File System The df command reveals the amount of. space avail- 


. able on each file system. Figure 6-6 shows a sample 
Maintenance df command response. a 


Filesystem kbytes used avail capacity Mounted on 


/dev/sd0oa 7495 5677 1068 84% 


/dev/sdic 129727 87887 28867 15% 
/dev/sdo0g 83623 66745 8515 89% 


Figure 6-6. Sample df Command Output 


NOTE | Using df at the beginning of each work day allows you 
to notice fast-growing file systems. When most of 
your maintenance time is occupied freeing small 
amounts of disk space, the addition of another disk 
drive is recommended. 
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Maintaining the Root 
File System 
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The amount of free space in the root file system rarely 
changes. You should keep approximately one-half 
megabyte free in the root file system, if possible. Di- 
minishing space in the root file system is most likely 
caused by one of the following: 


e New programs and scripts added to the root 
file system rather than to the /usr/local 
directory. 


e Program running in the root file system caus- 
ing a core dump (“core” files can be very 
large). 


e Growing accounting files; large output files 
can be created if the system accounting 
utilities are running and the files are not peri- 
odically purged. 


e Files not deleted from /tmp. Programs such as 
vi create temporary files in the /tmp directory 
which may not be automatically deleted upon 
completion of their tasks. 


When a file system is full, the system displays the 
message File System Full each time a user 
tries to do something that requires a “write” on the 
root file system. Since vi and other programs use the 
/tmp directory for temporary files, these programs 
also complains when the root file system is full. 
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Maintaining the User | Over time, your user file systems fill up with design 

File Systems data, output files from the SCALD analysis tools, 
memos and documentation that your users write. 
Here are some ways to eliminate unnecessary disk 
usage: 


e The optional on-line UNIX manual pages re- 
quire 4.5 Megabytes in the /usr file system. If 
you no longer require them, you can delete the 
manual pages from your system and use NFS 
to mount the manual pages from another sys- 
tem in your own /usr/man directory. To do 
this, first delete your system’s manual pages 
with the commands: 


cd /usr/man 
rm -r * 


Then add the following line to the /etc/fstab 
file: 


host:/usr/man /usr/man nfs ro,soft 0 0 


Replace host with the name of the server ma- 
chine. When you reboot the system, the man- 
ual pages from the server will automatically be 
mounted on /usr/man. 


The server must include /usr or /usr/man in its 
/etclexports file in order for you to mount the 
manual pages. 
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e By default, GED writes both an ASCII and a bi- 
nary copy of each drawing. In most cases, two 
files are unnecessary. 


To eliminate the slower ASCII file, place the 
command: 


set noascii 


in each user’s Startup.ged file. This tells GED 
to write only binary format output files. 


e Whenever a UNIX command or program 
crashes, including the SCALDsystem tools, 
UNIX creates an image of memory in the cur- 
rent directory, in a file named “core”. Periodi- 
cally you should delete all the “core” files on 
the system. 


Using find and rm to locate and remove all 
“core” files also deletes any user files coinci- 
dentally named core. To avoid deleting any 
user files by this name, use the command: 


find / -name core -print | mail root & 


This command generates a list of every core 
file on the system and then mails the list to 
root. Check with your users if there are core 
files in their directories, and remind them not 
to use the name “core” for any permanent 
files. 


6-24 | 2/15/90 


Design File Management 


Use the Ipc utility to clean the 
plotter spooling directories; 
see Section 7, Plotting, for 
more information. 
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vw.spool files from the GED hardcopy com- 
mand and the SCALDstar plotting utilities are 
often left in working directories. Periodically 
locate all of these files and ask their owners to 
delete the ones they no longer need. If a user 
wants to keep a large vw.spool file, suggest put- 
ting it on a tar tape. 


The command 
find / -name vw.spool -print | mail root & 


generates a list of all the vw.spool files on the 
system, and mails the list to root. 


Files that were spooled can accumulate in the 
directories under /usr/spool. Periodically check 
the contents of the spool directories: 


ls -l /usr/spool/* 


If the /usr/spool/mqueue directory contains old 
files, use pS —ax to check that the sendmail 
daemon is running. Then check to make sure 
that your network and uucp connections are 
operating properly. 


6-25 


Design File Management 


Users Who Overuse The du command reports disk usage, and can identify 

the Disk those users who have not deleted unnecessary files 
from their systems. With du, you can determine the 
number of kilobytes in specified directories and sub- 
directories. To check the disk usage in the /home file 
system, use the command: 


du /home > du.log & 


The command du lists every directory under the one 
you specify. After listing each file in a directory, du 
prints the total for the directory. Look for the sum- 
mary entry for each of the top directories in the file 
system: 


In the following sample of a du file, user Fred has 
5.681 Megabytes under his directory. 


EXAMPLE f 


5681 /hnome/ fred 
1200 /nome/gary 


4 /hnome/maureen 
2200 /nome/catie 
335 /nome/stuart 
11 /home/julie 


9431 /home 


Use the du command regularly to identify those users 
who utilize more space than needed on the disk. You 
will also spot directories that are growing rapidly, 
which may indicate a problem program. 
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Archiving a 
Design 
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Most users prefer to keep designs on-line, however, 
your disk cannot maintain an increasing number of 
files indefinitely. Once a design has been finished, it 
should be archived on tape and deleted from the disk. 
When creating an archive, always assume that some- 
one other than yourself will be restoring the design to 
the system. Be systematic, and document what you 
do. Here are some points to keep in mind: 


Put everything on the tape. Include all of the 
design directories, and all user-created library 
directories. Also include all user or site-spe- 
cific property.dat, textmacro.dat, and physical 
part table files. 


Put the component libraries on the tape. Since 
you might delete one of the libraries from your 
system at a future date, saving the libraries on 
the tape guarantees that you will have them 
available if you ever work on the design again. 


Put all supplemental documentation for the de- 
sign on the tape. 


Archive the command files and final output 
files for all SCALD tools, particularly the 
Packager output files. 


Make two copies of each tape, store one 
off-site and label all tapes clearly. 


Check each tape after you make it, and be sure 
you can read the contents by extracting the 
first and the last file. 
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The easiest way to archive a design is to use tar. 


Move to the design directory and delete everything 
you do not want to archive. This may include old 
memoranda and vw.spool files. 


Next, look at the startup.ged or startup.led file and 
check which libraries are used in the design. You 
should put the libraries on the tape. 


Careful planning of the tar command line will make it 
much easier to restore the design in the future. It is 
best to name the design directory in the command 
line, rather than using tar cv * from inside the direc- 
tory. Naming the design directory ensures, when you 
restore the design, that you end up with one new 
subdirectory under the current directory, rather than 
a large number of files. 


Move to the directory above the design directory by 
typing: 

cd 
For a simple design, such as one that was created ina 
single design directory and that uses only parts from 


the 74LSTTL library, the tar command might look 
like: 


tar cvf /dev/rstO projl -C /usr/valid/lib lsttl 


This command writes the design directory, “proj1” 
onto the tape, performs a Cd to /usr/valid/lib, and then 
writes the Isttl library onto the tape. 
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Note that the backslash (\) 
allows a long UNIX command 
to be continued onto a second 
line. 
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After you create the tape, use tar tvf to check that the 
tape was written successfully: 


tar tvf /dev/rstO >& archive.log 


The file archive.log contains a list of every file and 
directory on the tape. Look through the log file and 
make sure the tape is complete, then print archive.log 
and store it with the tape. 


When you read this tape with tar x, two directories 
are created under the current directory: /stt] and proj1. 
Once you’ve read the tape, you can move the library 
or the design directory using cp -r if necessary. 


For a more complicated design, you may need to put 
several design directories and user libraries on the 
tape: 


tar cvf /dev/rstO bigchip -C /usr/joe pads -C\ 
/usr2/mary cmosgates 
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This section describes: 


@ The printcap file 
e Valid supported plotters/printers 
© Plotting commands and utilities 


© Troubleshooting plotting problems 


Plotting 


The UNIX printer and plotter spooling mechanisms 
are described in the Sun System Administration for the 
Sun Workstation manual and the following UNIX man- 
ual pages: Joc (8), Ipd (8), loq (1), lpr (1), Iprm (1) 
printcap (5), and vpr (1V). Read the UNIX documen- 
tation before configuring your hardware. 


Tables 7-1 through 7-4 list the plotters/printers sup- 
ported by the Valid applications. If you need hard- 
ware and installation information on a plotter, see 
“Adding Additional Hardware” in the Sun Jnstalling 
UNIX manual. 


If you are using a plotter that is not supported by 
Valid, Valid’s optional PLOTTALK software can be 
used to create an interface to virtually any plotter. 
PLOTTALK is a Plotter Interface Library that is made 
up of a set of C library routines and C data structures. 
PLOTTALK is explained in detail in the PLOTTALK 


Reference Manual. 
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Configuring The 
Printcap File 


File Entry Syntax 
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The file /etc/printcap configures the system to spool 
printing and plotting jobs. 


Valid provides a prototype printcap file in the direc- 
tory /usr/valid/tools/adm/printcap.proto. The com- 
ments in this file explain how to generate printcap file 
entries for the plotters supported by Valid. Append 
this file to /etc/printcap and modify it, if necessary, to 
fit your needs. 


The prototype printcap file allows you to do local plot- 
ting on an 11-inch Versatec V-80, an HP7580 pen 
plotter, or an A-size postscript printer. If you want to 
support any other arrangement of plotters or printers, 
you must modify the printcap file. If your plotter or 
printer is shared by several machines on the Ethernet, 
each machine’s /etc/printcap file must be set up cor- 
rectly. 


The following syntax rules must be followed for the 
individual entries in the /etc/printcap file: 


eo The first configuration parameter on a line 
must be preceded by a tab; individual parame- 
ters must be separated by colons. 


© More than one configuration parameter can be 
included on a line (if separated by a colon). 


@ All but the last line must end with a line—con- 
tinuation character (‘\’), and the last line must 
be terminated with a colon. 
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System The following system considerations must be ob- 
Considerations served when setting up an /etc/printcap file entry: 


e The directory /usr/spool/hpd and the directory 
referenced by the “:sd=” configuration pa- 
rameter in the corresponding /etc/printcap file 
entry must exist to support plotting. 


e There must be one entry in the /etc/printcap file 
(and one spool directory) for each different 
type of printer or plotter you want to use. 


e If there are two entries with the same name in 
ihe file (e.g., two “gedpiot” entries), the first 
one is used. 


e If you want to print remotely over the Ethernet, 
there must be a corresponding local printer en- 
try on the remote host, and the remote host’s 
/etc/hosts.equiv file must include an entry for 
your host. 


e Only the spool directories for plotting GED 
drawings to 11-inch Versatec plotters and 
plotting to the HP7475 pen plotter are created 
automatically during Valid’s installation pro- 
cedure. (These directories, under /usr/spool, 
are vpd, hpd, vers11, and hp7475.) For any 
other plotter, including wider Versatecs and la- 
ser printers, you must create the spool direc- 
tory manually in /usr/spool. The printcap file 
examples show you the directory name to use. 
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e The following entry must exist. GED hardcopy 
will not work without this entry: 


gedplot | Used by GED Hardcopy: \ 
:mx#0:\ 
:lp=/dev/null: \ 
:if=/usr/valid/tools/editor/lib/hpf: \ 
:Ssd=/usr/spool/hpd: \ 
:St=/usr/spool/hpd/status: \ 

:if=/usr/spool/hpd/errorlog: 


e Inthe gedplot entry, mx specifies the maxi- 
mum size of the plot file (the value “#0” al- 
lows unlimited file sizes), and if is the output 
filter. Since the hpf filter program spools the 
plotter input file instead of sending it directly 
to the plotter, Jp must be set to “/dev/null.” 
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Entries for 
Versatec 
Plotters 


Versatec Text 
Device 
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If you have a Versatec (or comparable) electrostatic 
plotter, there must be at least two entries for the Ver- 
satec in /etc/printcap: one entry for Sun utilities (/dev/ 
vp0) and at least one entry for GED graphics. The GED 
graphics device entry is needed for plotting from 
within GED and for the UNIX Vpr command. These 
entries are in addition to the gedplot entry. 


Valid supplies a printcap entry for a Versatec text de- 
vice. This entry must be present for GED hardcopy to 
work. Also, the Sun supplied optional Versatec soft- 
ware must be installed when you run setup during sys- 
tem installation. Text is sent to the Versatec using the 
lpr command with the -Pversatec (or -Pvp) option. 
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The entry for a local 11-inch Versatec printer is: 


versatec|vp|Local Versatec printer: \ 
:lp=/dev/l1pvo: \ 
:mx#0: \ 
:pw#264: \ 
:pl#66:px#2112:py#1700:tr=\f: \ 
:of=/usr/lib/vpf:if=/usr/lib/vpf: \ 
:tf=/usr/lib/rvcat:cf=/usr/lib/vdump: \ 
:vf=/usr/valid/tools/bin/vplotv:\ 
:Sd=/usr/spool/vpd: \ 
:St=/usr/spool/vpd/status: \ 
:lf=/usr/spool/vpd/errorlog: 


The entry for a remote Versatec printer is: 


versatec|vp|Remote Versatec printer: \ 
elp=s\ 
:rm=remotehost: \ 
:rp=versatec: \ 


:Sd=/usr/spool/vpd:\ 
:St=/usr/spool/vpd/status:\ 
:lf=/usr/spool/vpd/errorlog: 
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For other Versatec sizes, change the px# and pw# en- 
tries according to the following table. 


Table 7-1. Versatec Px# and Pw# Entries 


Printer/Plotter Px# Entry Pw# Entry 


22-inch Versatec 
36-inch Versatec 
42-inch Versatec 
72-inch Versatec 
24-inch Color Versatec 


36-inch Color Versatec 


42-inch Color Versatec 
24-inch Benson (9424) 
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Local Versatec 
Graphics Device 
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A local graphics device entry must have two names in 
the first line. The first name is the name that GED and 
hpf recognize for the specific printer/plotter model, 
and the second name is the generic name “vplot.” The 
above entry is for an 11-inch Versatec; if you ask for 
an 11-inch Versatec in GED, the rasterization pro- 
gram (hpf) looks for a “vers11” entry. If it cannot 
find one, no plot is output. 


When adding or creating a printcap entry, make sure 
that there are no spaces between the vertical bars and 
the printer names themselves. Only the spooling di- 
rectories for 11-inch Versatec plotters are created 
automatically by the Valid installation procedure. 
You must manually create spooling directories for 
any of the other plotter models. Supported black and 
white and color vplot plotters and their corresponding 
GED/hpf names are listed in the following tables. 


The local Versatec entry for plotting looks like this: 


versl1|vplot|Versatec plotter: \ 
:lp=/dev/null:\ 
>mx#0: \ 
:of=/usr/valid/tools/bin/vplotf:\ 


:Sd=/usr/spool/vers1l1:\ 
:St=/usr/spool/vers1i/status: \ 
:lf=/usr/spool/versil/errorlog: 


7-9 


Plotting 


Remote Versatec The entry for the graphics device for remote plotting 
Graphics Device follows the previous pattern: 


versll1|vplot| remote 11" Versatec plotter: \ 
:ip=:\ 
:rm=remotehost: \ 
:rp=vers11:\ 
:sd=/usr/spool/vers11:\ 
:St=/usr/spool/versi1i1/status: \ 
:lf=/usr/spool/versi1l/errorlog: 


You can have more than one remote Versatec plotter 
if there is more than one size of Versatec on your 
network. You must have a separate spooling direc- 


tory for each size or type of printer or plotter. The 
entry for a second Versatec might look like: 


vers36|vplot| remote 86" Versatec plotter: \ 
:lp=:\ 
:rm=remotehost: \ 


:rp=verss6:\ 
:Sd=/usr/spool/vers36: \ 
:St=/usr/spool/vers36/status: \ 
:lf=/usr/spool/vers36/errorlog: 
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Table 7-2. Black and White Plotters 


vers11 Versatec V-80, Spectrum 2552 in B/W mode 


vers22 Versatec 7222 and 8222 

vers24 Versatec 7224 and 8224 

vers25 Versatec 7225 and 3224* in B/W mode 
vers36 Versatec 7236 and 8236, 3236* in B/W mode 
vers42 Versatec 8242 and 9242 in B/W mode 

vers44 Versatec 7224, 8244, and 3244” in B/W mode 
vers52 Versatec 8252 

vers59 Versatec 8259 

vers72 Versatec 8272 

versv81 Versatec V-81 

vers111 Versatec V-82 

vers122 Versatec 8122 

vers124 Versatec 8124 

vers136 Versatec 8136 

vers142 Versatec 8142 

vers172 Versatec 8172 

vers422 Versatec 7422 


*Support not verified 
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Table 7-3. Black and White Plotters (Continued) 


vers424 Versatec 7424 

vers425 Versatec 7425 and 3424* in B/W mode 
vers436 Versatec 7436 and 3436* in B/W mode 
vers444 Versatec 7444 and 3444* in B/W mode 
vers2554 Versatec Spectrum 2554 in B/W mode 
vers2556 Versatec Spectrum 2556 in B/W mode 
vers2558 Versatec Spectrum 2558 in B/W mode 
vers2562 Versatec Spectrum 2562 in B/W mode 
vers2564 Versatec Spectrum 2564 in B/W mode 
vers2566 Versatec Spectrum 2566 in B/W mode 
vers2568 Versatec Spectrum 2568 in B/W mode 
b9424 Benson 9424 in Versatec compatibility mode 
b9436 Benson 9436 in Versatec compatibility mode 


b9444 Benson 9444 in Versatec compatibility mode 


b9624 Benson 9624 in Versatec compatibility mode 
b9636 Benson 9636 in Versatec compatibility mode 
b9644 Benson 9644 in Versatec compatibility mode 
calcomp5744 Calcomp 5744 (Using 907/PCI interface) 


*Support not verified 
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Cvers24 
Cvers36 
Cvers42 
Cvers44 
Cvers424 
Cvers436 
Cvers444 
Cvers2700a 


Cvers2700b 


Cvers2700a3 


Cvers2700a4 


C3vrs2700a 


C3vrs2700b 


C3vrs2700a3 


C3vrs2700a4 


Table 7-4. Color Plotters 


Versatec 3224 in color mode 
Versatec 3236 in color mode 
Versatec 9242 in color mode 
Versatec 3244 
Versatec 3424 
Versatec 3436 
Versatec 3444 


Versatec C2700 series (C2736) 
A size paper, 4-color transfer 


Versatec C2700 series (C2756) 


B size paper, 4-color transfer 


Versatec C2700 series (C2766) 
A3 size paper, 4-color transfer 


Versatec C2700 series (C2726) 
Aé4 size paper, 4-color transfer 


Versatec C2700 series (C2736) 
A size paper, 3-color transfer 


Versatec C2700 series (C2756) 
B size paper, 3-color transfer 


Versatec C2700 series (C2766) 
A3 size paper, 3-color transfer 


Versatec C2700 series (C2726) 
A4 size paper, 3-color transfer 


Plotting 
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Pen plotters require both a printer entry and a gedplot 
entry in the printcap file. The first line of the printer 
entry requires the name that GED and hpf have for the 
various pen plotters. Supported pen plotters are listed 


Entries for Pen 
Plotters 
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in the following table. 


Table 7-5. Pen Plotters Supported by Valid Applications 


hp7580 
hp7580ex 


hp7475 
hpdraftrf 
hpdraftrfex 


b1624sr 
b1624 
b1625sr 
b1625 
b1834sr 
b1834 
b1835sr 
b1835 


calcomp1043 


Hewlett-Packard 7580B, 7585B, and DraftMaster 


Hewlett-Packard 7580B, 7585B, and DraftMaster 
in “expand mode” 


Hewlett-Packard 7475A 
Hewlett-Packard Draftmaster with roll-feed option 


Hewlett-Packard Draftmaster with roll-feed option 
in “expand mode” 


Benson 1624 (roll paper) 
Benson 1624 (cut sheet) 
Benson 1625 (roll paper) 
Benson 1624 (cut sheet) 


Benson 1834 (roll paper) 
Benson 1834 (cut sheet) 
Benson 1835 (roll paper) 
Benson 1835 (cut sheet) 
Calcomp 1043 (Using 907/PCI interface) 
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Local Pen Plotter An entry for a local pen plotter is: 


hp7580| local E size HP pen plotter: \ 
: lp=/dev/device: \ 
>mx#0: \ 
:br#9600:\ 


>sh=: \ 

:Sd=/usr/spool/hp7580: \ 
:St=/usr/spool/hp7580/status: \ 
:lf=/usr/spool/hp7580/errorlog: 


In the above example, sh (suppress header) is re- 
quired for all pen plotter entries. Also, the device 
specified by the /p parameter is the tty port attached 
to the plotter. Device can either be a specific port 
(e.g., “ttyb”) or logical port (e.g., “hp” with /dev/hp 
linked to a specific tty device such as “/dev/ttyb”). 
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Remote Pen Plotter A remote entry for a pen plotter is shown below. 


ate remote B size HP pen plotter: \ 
- lp}: 
:rm= Be eteacak 
:rp=hp7475: \ 


:sh= 

:sd=/usr/spool/hp7475: \ 
:St=/usr/spool/hp7475/status: \ 
:lf=/usr/spool/hp7475/errorlog: 


| In the above entry, the Jp parameter must be empty, 


and parameters must be added ‘for rm (remote 
machine) and rp (remote printer name). 
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Entries for GED plotting is supported by local and remote 

: A- and B-size laser printers with a postscript inter- 
Postscript face. These printers work with any RS-232 serial 
Printers plotter or laser printer that understands Postscript. 
Local Postscript The printcap entry for a local A-size postscript 
Printer (postscripta) printer is: 


2/15/90 


postscripta| local A-size laser printer: \ 
: lp=/dev/device: \ : 
:mx#0: \ 


:br#9600: \ 
:sd=/usr/spool/postscripta:\ 
:St=/usr/spool/postscripta/status: \ 
:lf=/usr/spool/postscripta/errorlog: 


In the above entry, the device specified by the Ip pa- 
rameter is the tty port attached to the printer. Device 
can either be described specifically (e.g., “ttyb”) or 
logically (e.g., “psa” with /dev/psa linked to a specific 
tty device such as “/dev/ttyb”). 


To plot to the laser printer, use the command set 
plotter postscripta or set plotter postscriptb while 
in GED. 
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Remote Postscript The printcap entry for a remote B-size postscript 
Printer printer (postscriptb) is: 


postscriptb| local B-size laser printer: \ 
:lp=:\ 
:rm=remotehost: \ 


:rp=postscriptb: \ 
:sd=/usr/spool/postscriptb:\ 
:St=/usr/spool/postscriptb/status:\ 
:lf=/usr/spool/postscriptb/errorlog: 


In the above entry, the /p parameter must be empty, 
and parameters must be added for rm (remote 
machine) and rp (remote printer name). 
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GED Plotting sc hardcopy in set local_plot mode works as 
ollows: 


1 GED sends Apf header information (plotter 
type, scale, etc.) and the binary or body draw- 
ing file to Apr. 


2 hpr, a shell script wrapper, calls /pr with the 
~Pgedplot option. 


3 The Jpd daemon is contacted, and the data is 
sent to the spool directory listed in /etc/printcap 
(in the /usr/spool/hpd directory). 


4 The /etc/printcap entry for gedplot instructs Ipd 
to run the filter program (in the directory /usr/ 
valid/tools/editor/lib/hpf ) on the data. 


5 hpf transforms the input data into a format ac- 
ceptable to the plotter and calls /pr with the - 
Pplotter_name option to send the formatted 
plotter file to the correct directory for the type 
of plotter specified. 


6 Another daemon then spools the plotter- 
specific files to the plotter. 


The double spooling (Steps 5 and 6) allows other pro- 
grams to access plotters in an orderly fashion, and 
keeps GED users from having to wait for their plots to 
be processed. 
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When GED is in set spooled_plot mode, Apf is used 
with the -f option (in stead of Apr) to create a vw.spool 
file. Since the /pr spooling system is not involved, the 
GED user must wait while hpf creates the vw.spool file. 


The following files and programs are involved in plot- 
ting: 


e /usr/valid/tools/editor/lib/hpr 
script that calls Ipd 


e /usr/ucb/Ipr 
program to enter job in spool directory 


e /usr/lib/lpd 


line printer daemon 


e /etc/printcap 
plotter setup configuration file 


e /usr/spool/spool_dir 
spool directory 


e /usr/spool/spool_dir/lock 
Status lock file 


e /usr/valid/tools/editor/lib/hpf 
plot data filter 
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Plotting 
Commands and 
Utilities 


vpr 


Note that the backslash (\) 
allows a long UNIX command 
to be continued onto a second 
line. The backslash is not en- 
tered in the command itself. 
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This section gives a brief overview of the UNIX 
plotting commands and plot queue monitoring 
facilities. 


In addition to the generic UNIX print and plot spooling 
commands /pr(1), Jorm(1), and /pq(1) there are three 
commands specifically for plotting and printing on 
Versatec plotters: 


The vor(1V) command spools a plot file for plotting 
on the Versatec plotter. It can be used to plot the 
vw.spool files created by GED Hardcopy or the 
Instaplot and Makepiot utilities. 


If you are plotting output files from Makeplot, Valid 
recommends that you not use the /pr spooling mecha- 
nism as the intermediate files would probably fill up 
your disk. Instead run the vp/otv utility directly using 
the /dev/Ipv0 option: 


cat vw.spool | /usr/valid/tools/bin/vplotv\ 
[-wwidth] > /dev/lpvo 


The example above works for the Ikon 10088 VME 
plotter interface. If you have an Ikon or Systech Mul- 
tibus plotter interface board, use the utility vplotm 
and the device vp0: 


cat vw.spool | /usr/valid/tools/bin/vplotm\ 
[-wwidth] > /dev/vpO 


The -w option specifies the number of bytes per line 
(264 for vers11). Additional vp/ot values for other 
plotters are as follows: 
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Table 7-6. Vplot Width Values 


11-inch Versatec 
22-inch Versatec 
36-inch Versatec 
42-inch Versatec 


72-inch Versatec 
24-inch Color Versatec 
36-inch Color Versatec 


s 
42-inch Color Versatec 


Benson 9424 


vpq_ | The vpq(1V) command lists the files in the Versatec 
plotting queue. 


vprm_ | The vprm(1V) command deletes a file from the plot- 
ting queue. 
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The Ipe Utility The line printer control utility Joc(8) allows the Sys- 
tem Manager to monitor and control the plotting 
queues. To start up the utility, enter the command: 


ipe 
The system displays the following prompt: 


lpc> 


EXAMPLE § 


mets atahaPatetatatatstataPataPatePataatatetatatetstat.tetatet Pets 80.2 50 


To check the status of the plotting and printing 
queues, use the status command, as follows: 


lpec> stat 
versatec: 
queuing is enabled 
printing is enabled 
no entries 
no daemon present 
gedplot: 
queuing is enabled 
printing is enabled 
no entries 
no daemon present 
versll: 
queuing is enabled 
printing is enabled 
1 entry in spool area 
no daemon present 
lpe> quit 


See the Joc (8) manual page for more details on this 
useful utility. 
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Troubleshooting 
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The first thing to do if you have trouble with plotting is 
to determine whether the problem is with the hard- 
ware or the software. The easiest way to check 
whether the hardware is operating correctly is to by- 
pass the spooling software and send a ww.spool file, 
preferably one you have plotted before, directly to the 
plotter filter. 


The following example invokes the versatec plot de- 
coder, sending the output directly to the device. The 
-W option specifies the number of bytes per line; the 
default is 264 for an 11-inch Versatec. 


cat vw.spool | /usr/valid/tools/bin/vplotv \ 
{-wwidth] > /dev/lpvo 


For pen plotters and postscript plotters, you can test 
the hardware with the command: 


cat vw.spool > /dev/ttya 


If necessary, substitute ttyb for ttya. 


If the plot comes out, you know that the hardware 
works. If the plot does not come out, check the ca- 
bling for the plotter and verify the plotter interface 
installation. 
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Configuring the 
Printcap File 


Hardcopy Error Log 
File 
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The file /etc/printcap configures the system to spool 
printing and plotting jobs. 


If your /etc/printcap file is correct and your system is 
configured properly for plotting, rebooting the system 
fixes most plotting problems and starts plotting of any 
jobs that were “stuck” in the plotting queues. How- 
ever, rebooting the system is not always convenient. 
The steps below show how to diagnose and fix 
common plotting problems. 


If you are having problems with hardcopy you may be 
able to determine the problem by looking at the error 
log. 


The error log is in the file /usr/spool/hpd/hpferrorlog. 
This file contains the last 3K bytes of error messages 
from the Apf program. Each invocation of Apf starts 
with the message: 


New invocation of /usr/valid/tools/editor/lib 
/npf: date 


After the header, error messages (if any) appear. 
Common problems include missing bodies and per- 
mission problems. Also, if you have discovered a bug 
in hpf or GED, the internal error messages in the log 
file will help pinpoint the problem. Print out a copy of 
this file and include it with the Software Problem Re- 
port when you report a plotting software problem to 
Valid. 
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Lpd Error Logs 
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The master [pd daemon has an error log file, /usr/ 
spool/Ipd—errs, for error messages. If you are trying to 
fix remote printing, look at Ipd-errs on the remote 
machine as well. Each copy of /pd for individual 
spool directories opens an error file if there is an /f 
entry in /etc/printcap (usually spool_dir/errorlog.) 
Check these for any error messages. 


Here are a few additional things to check: 


The owner of all the spool directories must be 
daemon; the group of all spool directories must 
also be daemon. 


The mode of all the s 


measaw 4448 


drwxrwxr-x (i.e., 775) 


The rp (remote printer) capability on the local 
machine must have an exact match with a 
name of a printer in the /etc/printcap file of the 
remote machine. 


The files within the spool directories (i.e., lock, 
status, errorlog, and .seq) must be owned by 
root and have daemon as the group. 


No spaces are permitted between the vertical 
bars that separate printer names and the 


printer names themselves in the /etc/printcap 
file. 
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e If you are trying to plot to a remote plotter, use 
the Ipc utility’s status command to check 
whether the plot is being successfully spooled 
to the remote system. If the plot shows up in 
the queue on the remote machine, the problem 
is not on your local machine. If you use [pc to 
stop printing, you can examine the print 
queues before the files are processed. 


e If you are trying to get hardcopy in GED to 
work, remember that the name of the printer 
in /etc/printcap must exactly match one of the 
names in the tables in the first part of this sec- 
tion. 


e Every machine that uses /pr must have a 
“printer” service entry in the file /etc/services, 
even for local printing. Also, the local and re- 
mote /etc/services files must agree on the serv- 
ice number for “printer” in order for remote 
printing to work. The default /etc/services file 
works fine, but you might have trouble if 
someone has modified the file. 


The default entry is: 


printer 515/tcp spooler 
#Line Printer Spooler 
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e Make sure there is at least one [pd daemon 
running. If not, log in as root and enter the 
command: 


/usr/lib/lpd 


If you change the printcap or services files, or 
change the ownerships of spool directories, 
use the pS -ax command to get the process ID 
numbers of all of the jod daemons, kill them, 
and then restart the daemon: 


kill -15 process _id 
/usr/lib/1ipd 
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Versatec Plotter 
Setup 


Setting Up Pen 
Plotters 


Baud Rate 
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See Appendix A for information on the installation of 
the Ikon 10088 VME bus plotter interface board. Also 
see the Sun manual Card Slot Assignments and Back- 
plane Configuration Procedures (Sun P/N 
813-2004-05) when checking the installation of the 
plotter interface board and your workstation’s 
Hardware Installation Manual. 


The correct back panel switch settings to use with the 
HP7580 pen plotter are: 


Parity off 

Parity odd 

Full Duplex 

Hardwire 

DTR Normal 

9600 Baud 

expand normal 
emulate normal 
standalone eavesdrop 
monitor mode normal 
local normal 


In 4.2BSD UNIX, when a non-login port closes, the 
baud rate is reset to the default: 9600 baud. This cre- 
ates a problem if you are trying to hook up a pen plot- 
ter that cannot accept 9600 baud. Baud rate is set 
automatically by the System Utilities sleeper program 
located in /usr/valid/tools/bin. If you need to reset the 
Baud Rate, use the following command: 


sleeper -b baudrate -f /dev/ttya & 


where baudrate is the required baud. 
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The file /etc/gettytab shows the baud rate codes to use 
in /etc/ttys. The most popular settings are: 


0 cycles between 100, 1200, 150, 110 
1 150 baud 

2 9600 baud 

3 cycles between 1200 and 300 

4 Decwriter (300 Baud) 

5 cycles between 300 and 1200 

6 2400 baud 

7 4800 baud 

8 cycles between 9600 and 300 


With sleeper running, the /pr(1) command should 
function at the selected baud rate. 
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IKON 10088 Interface 
Board Installation 


This section explains how to configure and install an 


IKON 10088 Interface Board on a Sun Workstation. 
Some of the topics covered in this section are: 


© Interface Board Swtich Settings 
e@ Cabling 
© VME-VME Adapter Installation 


e Non-generic Kernel Considerations 


Appendix A 


The Ikon 10088 interface board provides both TTL 
and differential outputs for a Versatec printer/plotter. 
The interface board is premounted on a Sun VME- 
VME adapter board to simplify installation. 


Hardware installation of the interface board involves 
verifying/setting the switches and jumpers, installing 
the interface cable between the appropriate interface 
board or VME-VME rear panel connector and the 
printer/plotter, and installing the Sun VME-VME 
adapter into an expansion slot in the chassis. 
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Interface Board 
Switch Settings 
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Individual switches are used to set the interface 
board’s base address, the driver type (TTL or differen- 
tial), and the word length (16 or 32 bits). These 
switches are shown in figure A-1. Before proceeding, 
make sure that toggle switch S2 (located between the 
two interface connectors) is in its neutral (center) po- 
sition. 


Appendix A 


Figure A~1. Switch/Jumper Locations 


A-4 


| 
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Base Address Switches U52, U53, and the first four positions of 
switch U54 determine the base address of the IKON 
interface board on the VME bus. These switches are 
set to base address E0000x (hexadecimal) according 
to the following table: 


Table A-1. Switch Settings 


U52 U53 U54 
Setting Setting Setting 


*Always set to OFF 
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Driver Type The type of driver (TTL or differential) is set by switch 
US54-7. If you are using a Versatec printer/plotter 
with a TTL interface, set switch U5S4-7 to OFF If you 
are using a Versatec printer/plotter with a differential 
(long-line) interface, set switch U54-7 to ON. 


Word Length The word length (16- or 32-bit) is set by switch 
U54-5. If you are installing the interface board in a 
Sun3, set switch U54-5 to ON (32-bit). Note that on 
the Sun3 or Sun4, switch U54-5 can be in either posi- 
tion; setting the switch ON improves the throughput by 
transferring data to the board in 32-bit increments. 
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Interface Board 
Jumper Settings 


Bus Grant Level 


Jumpers are used to set the bus grant, bus request, 
interrupt request, and interrupt acknowledge levels. 
The locations of these jumpers are shown in 
Figure A-1. 


The bus grant level is determined by the jumper con- 
figuration at the bus grant pin matrix (pins 10 through 
25). Jumpers are installed to select bus level 3 (the 
Sun CPU only responds to bus level 3) and to not pass 
through any of the other bus grant levels. To select 
bus level 3, install jumpers between pins 11-13, 
15-17, 19-21, 22-23, and 24-25 as shown in Figure 
A-2. 


Figure A-2. Bus Grant Pin Matrix 


Bus Request Level 


2/15/30 


The bus request level is determined by the jumper 
configuration at the bus request pin matrix (pins 26 
through 33). A single jumper is installed between 
pins 32 and 33 to select bus request level 3 as shown 
in Figure A-3. 
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Figure A-3. Bus Grant Pin Matrix 


Interrupt Request The interrupt request level is determined by the 

Level jumper configuration at the interrupt request pin ma- 
trix (pins 34 through 47). A single jumper is installed 
between pins 44 and 45 to select interrupt request 
level 2 as shown in Figure A-4. 


Figure A-4. Interrupt Request Pin Matrix 
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Interrupt The interrupt acknowledge level is determined by the 

Acknowledge Level jumper configuration at the interrupt acknowledge pin 
matrix (pins 48 through 61). A single jumper is in- 
stalled between pins 58 and 59 to select interrupt ac- 
knowledge level 2 as shown in Figure A-S. 


Figure A-5. Interrupt Acknowledge Pin Matrix 
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Miscellaneous In addition to the bus and interrupt jumpers, several 
Jumpers - | other jumpers must be installed for the interface 
board to function properly. Refer to Figure A-6 and 
verify that jumpers are installed between pins 2-3, 
4-5, 7-8, and 63-64 along the left side of the board. 


Figure A-6. Miscellaneous Jumpers 
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Cabling 


Internal Cabling 


2/15/90 


The Ikon 10088 interface board supports Centronics— 
compatible interface connectors for both a TTL anda 
differential (long line) cable interface. There are two 
VME-VME adapter cable configurations: internally 
connected directly on the Ikon board’s interface con- 
nectors and externally connected to the interface con- 
nectors on the the VME-VME adapter’s rear panel. 


With internal cabling (i.e., no cabling between the 
Ikon interface board and the VME-vME adapter’s rear 
panel), the plotter cable is connected directly to the 
interface board’s J1 or J2 connector. The plotter in- 
terface cable must be installed before installing the 
VME-VME adapter into the expansion chassis. The 
TTL cable is installed in the interface’s J2 connector, 
and the differential cable is installed in the interface’s 
Ji connector. The type of interface is determined by 
switch U54-7 (see Interface Board Switch Settings). 


Insert the cable interface mating connector into the 
appropriate board connector (J1 or J2) and secure it 
in place with the mounting screws. To reduce strain 
on the connector, secure the cable to the VME-VME 
adapter with a cable tie. 
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External Cabling 
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With external cabling (i.e., interface connectors 
mounted on the VME-VME adapter’s rear panel), the 
plotter interface cable is connected to either the J1 or 
J2 connector on the rear panel of the VME-VME 
adapter. The plotter interface cable should be in- 
stalled after installing the VME-VME adapter into the 
expansion chassis (see the next section). The TTL 
cable is installed in connector J2, and the differential 
cable is in stalled in connector J1. The type of inter- 
face is determined by switch U54-7 (see Interface 
Board Switch Settings). 


Insert the cable interface mating connector into the 
appropriate rear panel connector (J1 or J2) and se- 
cure it in place with the mounting screws. 
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VME-VME 
Adapter 
Installation 
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The VME-VME adapter is installed in slots 6-9 of the 
Sun back plane (slots are numbered from 1-12 with 
the Sun CPU board installed in slot 1). If you are using 
an adapter with internal cabling, a slot with an unused 
adjacent slot must be used. Install the VME-VME 
adapter into the selected slot and secure it in place 
with the top and bottom mounting screws. 


After installing the VME-VME adapter in its slot, ver- 
ify that jumpers Px03 and Px04 on the front of the 
backplane are removed. To check these jumpers: 


1 Make sure that the system is powered down 
and disconnect the ac line cord. 


2 Remove the front panel bezel. The bezel is 
held in place with six internal wire-spring fas- 
teners that release when the bezel is pulled 
away from the chassis. 


3 Remove the four screws that hold the power 
supply pull-down drawer to the chassis. 


4 Pull the drawer out from the top and carefully 
lower it into its fully open position on its sup- 
ports. It may be necessary to pry the top of the 
drawer out from the chassis due to the tight fit 
of the RFI strip. 
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5 Refer to Figure A-7 and make sure that the 
Bus Grant and Interrupt Acknowledge jumpers 
at Px03 and Px04 on the front of the backplane 
connector where the VME-VME adapter is in 
stalled have been removed. (x is the number 
of the slot where the adapter is installed). 


6 Raise the power supply drawer back into the 
chassis and secure it in position with the four 
screws removed in step 3. 


7 Replace the front panel bezel and the ac line 
cord and apply power to the system. 


REMOVE THESE JUMPERS eae 


(x INDICATES SLOT NUMBER) 


caer 


Figure A~-7. Backplane Jumpers 
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Software 
Installation 
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NOTE 


Software installation is described in Section 2 of this 
manual. During setup, be sure to install the Sun- 
supplied optional Versatec printer software and then 
use vscript to install the Valid System Tools package. 
After vinstall completes, execute the mkvaliddevices 
script: 


/usr/valid/tools/bin/mkvaliddevices 


This script runs mknod(8) to create the appropriate 
character special devices in /dev. 


The mkvaliddevices script overwrites all devices of the 
same name. 


Edit the /etc/printcap file and merge in the Valid sup- 
plied printcap entry for the Versatec as described in 
Section 7 of this manual. After editing the printcap 
file, be sure to kill and restart the line printer daemon 
(Ipd). 
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Non-generic The IKON 10088 driver requires a special (non- 


generic) kernel. Valid supplies modified kernels to 
Kernel support both the IKON 10088 driver and the Real 


Considerations Products drivers. See Appendix B for more 
information. 


A-16 2/15/90 


Real Products and 
Versatec 
Printer/Plotter Kernels 


This section explains how to configure a custom kernel 


for Real Products or the Versatec printer/plotter on a 
Sun Workstation. Topics covered in this section are: 


e Installing and configuring your kernel 


e Configuring your custom kernel 


Appendix B 


Installing and 
Configuring the 
Kernel 
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If you have a Versatec plotter or Valid Real Products, 
you need to configure the kernel on the machine to 
which the hardware is attached in order for the kernel 
to recognize the hardware. Valid provides a kernel 
that contains the drivers for these particular products. 


If you are using Sun’s generic kernel, you can simply 
replace the Sun kernel with Valid’s modified kernel. 
If you are using a modified Sun kernel, you must 
make a new kernel that includes the Valid device driv- 
ers. 


To check if your kernel has been modified, use the 
command: 


strings /vmunix | grep Release 
The result should be something similar to: 
SunOS Release 4.0.3 (Generic) #4:date 


Check the Sun release number (4.X) and the kernel 
type. If your kernel is not generic, see “Configuring 
Custom Kernels” later in this section. 
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Installing the Valid If you have a generic Sun kernel, perform the follow- 
Kernel ing steps to replace your Sun kernel with the appropri- 
ate Valid kernel. 


1 Determine which Valid kernel to use as the re- 
placement kernel by entering: 


/usr/valid/tools/bin/kversion 


The kversion command reports the release 
level of the Sun kernel and identifies which 
Valid kernel should be used. 


2 Change to the Valid kernel directory and iden- 
tify the kernel reported by the kversion com- 
mand (e.g., vmunix.sun3.os4.X) 


cd /usr/valid/tools/kernel 
ls 
3 Copy this kernel onto the root file system: 


cp vmunixXxX.Y /vmunix.valid 


4 Shutdown the system by typing: 
sync 
sync 
Shutdown +n 
(n is time in minutes) 
5S When the PROM monitor prompt (>) appears, 
reboot the system with the Valid kernel: 


b vmunix.valid 
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6 After the system boots up, execute a few sim- 
ple commands to make sure that the system is 
functional. Use the df command and make 


sure all of your disk drives appear. (Note that 
commands like ps that read the kernel’s sym- 
bol table will not work properly until you com- 
plete the next step.) 


7 Backup the old kernel (/vmunix) to tape using 
tar(1). Save the tape. Then rename the ker- 
nels: 


mv /vmunix /vmunix.old 
mv /vmunix.valid /vmunix 


Configuring If you are using a non-generic or “custom” Sun 


Cust K I kernel, and if you are using Versatec plotters or Valid 
USTOM INEFNels Realproducts, you will need to add the necessary 


device drivers to your kernel. The procedures for 
adding the Realproducts driver are found in the 
README file in one of the following directories: 


/usr/valid/tools/kernel/realproducts/4.0 
/usr/valid/tools/kernel/realproducts/4.0.3 
Instructions for adding the Versatec Ikon10088 plotter 


driver can be found in the file /nstallation in the direc- 
tory /usr/valid/tools/kernellikon10088. 
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Device and Spooler 
Scripts 
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NOTE 


Next, you must create the Real Products and Versatec 
plotter devices by running the script mkvaliddevices. 


To run the script, log in as root and enter the 
command: 


/usr/valid/tools/bin/mkvaliddevices 


The mkvaliddevices script overwrites all devices of the 
same name. 


After you run the mkvaliddevices script, you must run 
the spooler installation script on each system that has 
a local disk. To run the spoolsetup script, log in as 
root, and enter the following command: 


/usr/valid/tools/bin/spoolsetup 


The spooler installation script sets up your system for 
GED plotting to 11-inch Versatec plotters, HP7580 
pen plotters, and postscripta plotters. 


Using vinstall 


This section provides additional information about the 


vinstall utility. 
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The vinstall 
Utility 


-V 


- 


-f devicename 


The vinstall utility is called automatically by the 
vscript installation script during installation of the 
Valid applications. A copy of vinstal/ is included in 
/usr/valid/tools/bin when the Valid System Utilities 
package is installed. 


vinstall [-options] feature_name 


Several options to vinstall can be used directly to ver- 
ify or delete Valid application packages. By default, 
all packages are reported if a specific application is 
not indicated in the command line. 

reports the version of an installed application. 
reports the latest version of an installed application. 
reports the installation history of an application. 
deletes a previously installed application. 


resumes a failed or stopped installation. 


installs from a tape drive other than /dev/rst0. Please 
note that the -f option is only used for special installa- 
tions, if instructed by Valid. 
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Errors and Warnings 


Incomplete Installation 
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If problems occur during the installation, vinstall 
usually describes the nature of the problem before 
exiting. Check the /tmp/vinstall.msg file for error 
messages. 


The following message appears when incomplete in- 
stallations occur: 


Warning!! According to the lock file /usr/ 
valid/tools/adm/vinstalllock, an incomplete 


installation was done of feature_name 


The vscript installation script is used to reinstall a 
specific application. 


1 Change directories by typing: 


cd /usr/valid/install 


2 Run the installation script by typing: 


vscript 


3 You are prompted for user-specific informa- 
tion regarding the kind of tape and the kind of 
executables you are installing. You are then 
asked to select the package to be installed. 
Enter the number that corresponds to the fea- 
ture_name included in the warning message. 


For complete information regarding installation, see 
Using Vscript, Section 2. 
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Corrupt History File If for any reason the vinstall history file vinstallhist 
becomes corrupt, the following error message is dis- 
played: 


Vinstall: Fatal error in /usr/valid/tools/adm/vinstallhist on line N 
This problem might occur if you try to do an installation with a full 
file system. To fix the problem, delete the indicated line from the 
/usr/valid/tools/adm/vinstallhist file, make room on your disk for the 


new software or libraries, and run vinstall again. Note that if the 
problem persists, restore the original vinstallhist file from your 
backup tape and again run vinstall. 


Deleted Files from During an update installation, if files from the previ- 
Previous Installation ous version of an application are missing, vinstall 
reports: 


Warning: The file filename does not exist on 
this system 


The missing file is replaced by vinstall if it exists on 
the current tape. If the license file has been deleted or 
corrupted, use vscript to reinstall the file. 
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Valid Products 


This section provides the corresponding feature names 


for all Valid products. 


Appendix D 


The following table lists all Valid products and the 
correct feature name for each product. When using 
Valid utilities that require feature_name in the com- 
mand line, please use the exact names provided 


Feature Names 


below. 


PRODUCT NAME 
allegro_bd 


allegro_bi 


allegro_br 


allegro_engineer 


allegro_md 


allegro_multiwire 
allegro_prep 


allegro_review 


allegro_therm 
allegroif 


FEATURE NAME 


arouter 
intrroute.o 
pceb_editor 
placement 
swap 
tgilocal.o 
peb_editor 
tgilocal.o 
arouter 
placement 
swap 
peb_engineer 
placement 
swap 
tgilocal 
mdin 

mdout 
multiwire 
pceb_prep 
tgilocal.o 
pceb_review 
placement 
swap 
tgilocal.o 
thermal.o 
gallegro 
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PRODUCT NAME 


applicon 


cadds 
cadds4x 


calay 
calaypcb 
cbds 

cif 
compare 


compiler 


compose 
cadam 
led_dre 
confirm_dre 
construct 
flattener 


fsim 


ged 
hardcopy 
hdl 

hilo 


FEATURE NAME 


gappfeed 
gapplicon 
gcadds 
gc4xfeed 
gcadds4x 
gcalay 
gcalfeed 
gcalaypcb 
gcalpfeed 
gcbds 
ecbdsfeed 
cif2led.ex 
led2cif.ex 
compare. ex 
comp 
expgen 
pcomp 
compose.ex 
gcadam 
drce.ex 
dre.ex 
construct 
flat 
xrefer 
fsim 
refsim.o 
test_man 
ucpfsim.o 
ged.ex 

hpf 

ghdl 

ghilo 
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intgraph 
lasar 
led 
logcap 
makeplot 
mcldl 
packager 


spiceif 


Standardif 


stream 


tegas 
time 
timeview 
timemill 
pathmill 
gtimemill 


gintgraph 
glasar 
led.ex 
glogcap 
plot.ex.color 
gemcldl 
packager 
gphilpac 
gredac 
gredfeed 
grinf 
grinfeed 
gescicards 
gscifeed 
gsecfeed 
gsecmai 

sim 

ucpsim.o 
espice 

gbom 

glib 
gphysdly 
gscald 
gspares 
led2stream. ex 
stream2led.ex 
gtegas5 
verifier 
tvad 
timemill 
pathmill 
gtimemill.ex 
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PRODUCT NAME FEATURE NAME 


transcribe tscr.ex 
crefer 
wirewrp gwirewrp 
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A 


Access Control 
adding servers, 3-9 
configuring servers, 2-23 
fault tolerant mode, 3-2, 3-3 
number of licenses requried, 2-22 
overview, 3-2 
starting the daemons, 3-2 
troubleshooting, 3-19 


Access Control files 
license. HOSTID, 2-16, 2-23, 3-11 
license.log, 3-11 
options, 3-11, 3-15 
servers, 3-11 


Access Control utilities 
valid_report, 3-17 
valid_status, 3-16 


access, group, 6-4 

active license server, 2-30 

add command, 5-8 

adding servers, 3-9 

Allegro (PCB) PATH variable, 2-15 
archiving, using tar, 5-14 


archiving designs, 6-27 
using tar, 6-28 
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index 


B 


backslash (\) symbol, 3-21 
backup 
See also dump 
design archive tapes, 6-27 
utilities, UNIX, 5-3 
baud rate for printers, 7-29 
Bourne Shell, selection, 4-4 


Bourne shell command, starting the 
daemons, 3-21 


Cc 


C Shell, selection, 4-4 
C shell command, starting the 
daemons, 3-21 
cabling, A-11 
cd command, 5-6 
changing permissions, using chown, 
2-15 
chmod command, 6-8, 6-9, 6-10 
chown command, 2-15 
commands, 6-13 
add, 5-8 
ced, 5-6, 5-7 
chmod, 6-8, 6-9, 6-10, 6-12 
chmod g+w, 6-12 
chmod o-rwx, 6-12 
chmod og-rwx, 6-13 


Index 


commands, con’t. 

cherp, 2-15 
chown, 2-15 
df, 6-21 
du, 6-26 
dump, 5-5, 5-10 
export, 4-16 
find, 6-9 
hardcopy, 6-25 
hostid, 2-16 
kill, 3-8 
kversion, B-3 
Is, 4-12, 5-7, 6-10, 6-11, 6-14 
mkdir, 6-17 
more, 6-10 
mount, 2-12, 2-30, 6-17 
mount —a, 2-30 
newfs, 5-10 
passwd, 4-8, 4-10 
ps, 2-26, 3-8 
ps waux, 3-21, 6-25 
pwd, 5-7 
quit, 5-9 
rdump, 5-10 
restore, 5-4, 5-6 
rm, 4-11 
set, 4-14 

set noascii, 6-24 

setenv, 4-13 
shutdown, 6-13 
status, 7-23 
tar, 2-17, 3-9 

tar -f, 5-15 

tar c, 5-15 

tar x, 5-15 


l-2 


umask, 6-10, 6-12 
umask 002, 6-7, 6-12 
umask 007, 6-12 
umask 077, 6-13 

yppasswd, 4-8, 4-10 


communication port, reserving, 2-24 
configuring custom kernel, B-2 
configuring disk space, 2-4 
configuring servers, 2-10 

copying designs, backup, 6-27 


creating accounts 
for users, 4-2 
with Yellow Pages, 4-2 


creating the lib account, 2-14 
creating the links, 2-14 
creating the Valid directories, 2-13 


creating user accounts, selecting shell 
Bourne, 4-4 
C, 4-4 


.cshre file, 2-15 
custom kernel configuration, B-2 


D 


daemons 
license manager (Jmgrd), 2-23, 3-21 
validl, valid2, 2-24 


daemons line printer, 7-27 
daily backup, example, 5-5 
dd, backup utility, 5-3 

default disk partitions, 2-8 
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Index 


default file permissions, 6-11 


default files 
.cshrc, example, 4-14 
login, example, 4-13 
.profile, example, 4-16 


default user files, 4-12 

design directories, mounting, 6-17 
design directory, example, 6-3 
dev/vplot termcap entry, 7-7 
dev/yprint termcap entry, 7-7 

df command, 6-21 


directories 
bin, 2-5 
creating, 6-4, 6-17 
design, 6-3 
drawing, 6-3 
/home/valid, 2-5 

' remote mounting, 6-17 
SCALD, 6-15 
spooling, 7-9 
using mkdir, 6-17 


directory hierarchy, 6-2 
directory name, 6-16 
disk partitions, 2-8 


disk space 
file system maintenance, 6-21 
requirements, 2-4 


disk space requirements 
applications, 2-6 
libraries, 2-7 
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disk usage, checking, 6-26 
drawing name, rules, 6-16 
du command, 6-26 

dump, backup utility, 5-3 


dump command, 5-5, 5-10 


E 


editing templates, 2-25 

editing the DAEMON entries, 3-7 
editing the servers file, 2-27 
encryption, 2-24 

error file, hardcopy, 7-25 

error messages, message file, 2-20 
errors in installation, 2-20 
case-sensitivity, 6-10 


letc files 
lexports, 2-28 
/fstab, 2-12, 2-29 
/gettytab, 7-30 
/group, 2-14 
/passwd, 2-14 
/printcap, 7-3 
/rc.local, 2-25 
/rc.valid, 2-25, 3-8 
/services, 2-24 


export command, 4-16 


external cabling, A-12 


Index 


a 


fault tolerance, 3-2 
license distribution, 3-4 


fault tolerant mode, access control, 3-3 
FEATURE entry, license file, 2-24 


feature names, 3-16, 3-17 
table of, D-2 


file ownership, security, 6-5 
file restoration. See restore 
file servers (non-access) 2-31 


file system maintenance, 6-21 
disk snace, 6-21 


maintaining root, 6-22 
user files, 6-23 


files 
.cshre, 2-15 
errorlog, 7-25 
letclexports, 2-28 
letc/fstab, 2-12, 2-29 
/etc/group, 2-14 
letc/passwd, 2-14 
letc/rc.local, 2-25 
/etc/rc.valid, 2-25, 3-8 
/etc/services, 2~24 
gettytab, 7-30 
hosts.equiv, 7-4 
license. HOSTID, 2-23 
Ipd-errs, 7-26 
options.template, 3-5 
printcap, 7-3 
.profile, 2-15 
.rhosts, 4-2 


I-4 


files, con’t. 


servers.template, 2-27 
services, 7-27 
/tmp/vinstall.msg, 2-20, C-3 
/usr/tmp/license.log, 3-13 


find command, 6-9 
forgotten passwords, 4-10 


G 


group ID numbers, 4-4 
H 
hardcopy, 6-25 
error log file, 7-25 
hardcopy command (GED), 7-19 


/home/valid, linked to /usr/valid, 2-14 


host ID number, identifying the server, 
2-16 


hosts, 7-4 


ID numbers, group and user, 4-4 

identifying the server, 2-16 

IKON interface board, base address, 
A-5 


installation, overview, 2-2 
error messages, 2-20 
first-time, 2-13 
requirements, 2-2 
using vscript, 2-17 


2/15/90 


Index 


installing new license file, 3-9 

installing Sun3 and Sun4, 2-21 

installing the Valid applications, using 
vscript, 2-16 

installing the Valid kernel, B-3 


installing Valid software, first-time, 
2-13 
interface board 
installation, A-2 
jumper settings, A-7 
switch settings, A-3 


internal cabling, A-11 


L 


lib, adding a lib account, 2-14 


libraries 
disk space, 2-7 
file permissions, 6-18 
location of, 2-5 
Isttl, 6-18 
master library, 6-19 
master.lib, 6-19 
ownership, 6-18 
SCALD, 6-18 


license availability, fault tolerance, 3-4 
license file, DAEMON entries, 3-7 


license manager, starting the daemons, 
2-26 


license manager daemon, 2-23 
killing the process, 3-8 
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license.HOSTID file, 2~23 
changing location, 3-13 
new license file installed, 3-9 
reinstallation, 3-13 
sample diagram, 3-11 
syntax, 2-23 


license.log file, sample, 3-13 
linking the tools directories, 2-14 
Imgrd, license manager, 2-23 


location 
of Valid libraries, 6-2 
of Valid software, 6-2 


location of applications, 2-5 

Ipe utility, 7-21 

Ipd daemon, 7-27 

Ipd-errs, file, 7-26 

Is -a command. See ls command 


ls command, 4-12, 5-7, 6-10 
Is -l, 6-11, 6-14 


M 


MAIL variable, 4-13 
maintaining file system, 6-21 


master library, 6-19 
master.lib, example, 6-19 


maximum number of licenses, 2-33 


message file, errors during installation, 
2-20 


index 


mixed architecture N 
copying the servers file, 2-28 
installation, 2-21 network plotting across, 7-4 
installing new license file, 3-9 BAe 
reserving licenses, 3-6 new license file, installing, 3-9 
mkdir command, 6-17 newfs command, 5-10 
mkdir utility, 2-13 number of licenses, 2-24, 2-33 
mknewpwentry, 4-5 
mknod, A-15 O 
mkscaldusr, 4-5 
mkusr options file, sample, 3-15 


for design directories, 6-4 
on Yellow Pages server, 4-2 
problems with, 4-5 ownership, 2-15 
system requirements, 4-2 
troubleshooting, 4-5 
mkusr utility, 4-2 Pp 
mkvaliddevices, A-15, B-5 


more command, 6-10 


options.template file, 3-5 


package selection, 2-19 


passwd command, 4-8, 4-10 
mount command, 2-12, 6-17 ; 

; ; password file, create new entry, 4-5 
mounting, remote directory, 6-17 


mounting file servers, 2-31 password protection, 2~16 


passwords 
changing, 4-10 
changing root, 4-10 
forgotten, 4-10 
using passwd, 4-8 


mounting file systems, 2-30 


multiple client configuration 
making the directories, 2-29 
mounting the server, 2-29 


multiple server configuration 
starting the daemons, 2-26 
license availability, 3-4 pen plotters, HP, 7-14 


pen, plotters, 7-14 
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permissions 
default, 6-11 
default file, 6-4 
execute, 6-10 
libraries, 6-18 
program, 6-13 
read, 6-10 
script, 6-13 
set-group-ID, 6-14 
set-user-ID, 6-14 
special 
permission bits, 6-14 
sticky bit, 6-14 
strict, 6-13 
using Is -l, 6-11 
write, 6-4, 6-10 


plot spooling, 7-3 


plotters, 7-7 
pen, 7-14 


plotting 
error logs, 7-25 
ged, 7-19 
monitoring the queues, 7-21 
printcap file, 7-3 
queues, 7-21 
remote, 7—4 
troubleshooting problems, 7-24 


plotting across the network, 7-4 
primary license server, 2-23 


printcap file, 7-3, 7-25 
plotting, 7-3 
syntax, 7-3 
troubleshooting, 7-24 
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Index 


printers 
baud rate, 7-29 
laser, 7-17 
postscript, 7-17 


.profile file, 2-15 


project security 
simple, 6-4 
Strict, 6-4 


ps -ax command, 6-25 
PSI variable, %, 4-16 
pwd command, 5-7 


Q 


quit command, 5-9 
quitting the installation, 2-18 


R 


rc.valid, 2-25, 3-8 
rdump command, 5-10 
remote mounting, 6-17 
removing users, 4-11 
report generator. See valid_report 
utility 
required disk space, 2-6 
libraries, 2-7 
RESERVE entry, options file, 3~—5 
reserving communication port, 2-24 
reserving licenses, 3-5 
restarting the daemons, 2-28, 3-7 


|-7 


Index 


restore, i/f/v/b flags, 5-7 

restore command, 5-6 

restoring file systems, 5-10 
restoring files, 5-6 

rm -r command. See rm command 
rm command, 4-11 


root 
See also super—user 
file system maintenance. See super- 
user 


root password, changing, 4-10 


running vscript, 2-18 


S 


sample options file, 3-15 
saving designs, 6-27 

SCALD directories, 6-15 

SCALD directory, example, 6-15 


SCALD/UNIX directories, relationship, 
6-15 


script permissions, 6-13 


security 
file ownership, 6-5 
simple, 6-4 
strict, 6-4 


selecting packages, 2-19 


server configuration, 2-10 


I-8 


servers file, 2-27 
updating information, 2-28 


set command, 4-14 

set noascii command, 6-24 
setenv command, 4-13 

setting the PATH variable, 2-15 
shutdown command, 6-13 
simple mode, 3-3 

software installation, 2-2 


software organization, 2-5 
standalone systems, 2-9 
two-disk systems, 2-9 


special permissions, user-ID, group-ID 
sticky bit, 6-14 


spooling plots, 7-3 

standalone systems, software organiza- 
tion, 2-9 

standby license servers, 2-30 

starting the daemons, 2-26, 3-2 


Bourne shell command, 3-21 
C shell command, 3-21 


startup files 
.cshre, 4-5 
login, 4-5, 4-5 
.profile, 4-5 
re.valid, 2-25, 3-8 
super-user, 4-7 
Startup.ged file, 4-5 
status command, 7-23 


strict permissions, 6-13 
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Sun Microsystems 
Sun documentation, 1-2, 2-2 
Sun executables, 2-18 
location of, 2-10 
Sun installation, 2-11 
Sun operating systems, 2-11 
Sun programs, requirements, 2-11 


Sun VME-VME adapter, installation, 
A-2 


Sun3, Sun4 licenses, 3-5 


super-user 
creating accounts, 4-2 
file system maintenance. See root 
mounting remote directory. See root 
startup files, 4-7 
switch/jumper locations, A-4 
symbolic link, 2-10 
symbolic links, creating, 2-14 
syntax, printcap file, 7-3 
system maintenance, user files, 6-23 
System Tools, installing, 2-21 


T 


tar 
archiving, 5-14 
archiving designs, 6-28 
backup utility, 5-3 
c/v/f/b flags, 5-15 


tar command, 2-17, 3-9, 5-14 
tar c command, 5-15 
tar x command, 5-15 
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index 


TCP/IP port, 2-24 
template files, editing, 2-25 
text editor, vi, 6-10 


/tmp/vinstall.msg file, error messages, 
2-20 


troubleshooting access control, 3-19 


U 


UNIX files, location of, 6-2 
UNIX utilities, backup, 5-3 
umask command, 6-10, 6-12 

.login file, 6-7 

.profile file, 6-7 
unavailable licenses, 2-33 
UNIX directories 

creating, 6-4 

location of, 6-2 
updating the servers file, 2-28 
user accounts 

creating, 4-2 

ID numbers, 4-4 


user file systems, file system mainte- 
nance, 6-23 


user ID numbers, to find, 4-4 
user passwords, password file, 4-8 
users, removing from system, 4-11 


utilities, 7-21 
dd, 5-3 
dump, 5-3 
Ipc, 6-25 


Index 


utilities, con’t. 
mkdir, 2-13 
mknewpwentry, 4-5 
mknod, A-15 
mkscaldusr, 4—5 
mkusr, 4-2, 6-4 
mkvalddevices, A-15 
mkvaliddevices, B-5 
tar, 5-3, 5-14 
valid_report, 3-17 
valid_status, 3-16 
valid_status -a, 3-7 
vinstall, C-2 
vscript, 2-12, 2-16, 2-17 
vscript —p, 3-9 


V 


Valid applications 
disk space, 2-6 
location of, 2-5 
physical location of, 2-13 


. Valid executables, location of, 2-5 


Valid products, feature names, 3-16, 
D-2 


Valid Real Products, B-2 


Valid software installation, 2~2 
using vscript, 2-12 


Valid software organization, 2-5 


valid_report utility, 3-17 
sample report, 3-18 
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valid_status -a, 3-7 
valid_status utility, 3-16 
sample display, 3-16 
valid] daemon, 2-24 
valid2 daemon, 2-24 
Versatec plotter configuration, B-2 
vi, text editor, 6-10 


vinstall 
for Sun3 workstations, 2-16 
for Sun4 workstations, 2-16 


vinstall errors, C-3 

vinstall utility, C-2 

VME-VME adapter, installation, A—13 
vplot termcap entry, 7-7 

vpq command, 7-21 

vprint termcap entry, 7-7 

vprm command, 7-21 

vscript, 2-12 


W 


write permission, using vi, 6-10 


Y 


Yellow Pages, creating accounts, 4-2 
yppasswd command, 4-8, 4-10 


Symbols 
% primary prompt, 4-16 
\ backslash, 3-21, 6-29 
> restore prompt, 5-7 
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